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Preface 


Documentation Conventions 


Use of Fonts 


Naming Scheme for Reference 
Manual Pages 


Various fonts are used in this manual to distinguish what you type from what the 
system types at you, and to identify those items for which either you or the sys¬ 
tem must substitute a variable. Our conventions are: 

SMALL CAPS 

Names spelled wifli aU capital letters (such as, UNIX and FOR¬ 
TRAN) are printed in small caps for readability. 

bold listing font 

This font indicates things that you should type at your workstation. 

italic font This font is used as a place holder for words, numbers, or expres¬ 
sions that you define. Examples of these are: file names, function 
arguments, variables, and field names. Italics are also used in the 
conventional manner to emphasize important words and phrases. 

listing font 

This font indicates what the system types back at you. It also indi¬ 
cates literal values such as program names, function names, pro¬ 
cedure names, variable names, field types, file listings, and session 
output. 

References to commands and utilities from the Commands R^mence Manual for 
the Sun Workstation and the System Interface Manual for the Sun Workstation 
use the notation: 

passwd(l) 

to indicate the passwd page in Section 1 of the manual pages. TTiere are a total 
of eight sections: Sections 1,6,7, and 8 appear in the Commands Reference 
Manual; sections 2, 3,4, and 5 appear in the System InterfaceManualr T^x^^ 
passwd (5) means refer to the pas swd manual page in the Section 5 pages of 
the System Iruerface Manual. The notation spline(lG)meani§ !hatthisisa 
Graphics command in the Section 1 pages — you’ll also see the addended letter 
to indicate other subsections, like title (3M) for a page in the Math Library 
subsection of the Section 3 pages, or t it le (3N) for a page in the Network 
Library subsection. 
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Installing the SunOS™ 


This manual is designed to help you install Sun’s operating system onto your Sun 
woikstatioa Our goal is to help you to take your workstation fiom initial 
hardware power-up through the SunOS'™ installation 

A major portion of this document is devoted to suninstall, the Sun software 
installation tool, suninstall is a terminal based interface that provides you with a 
friendly, intelligent editor that allows you to do the following: 

o Install a new system 

□ Re-instaU an existing system 

□ Upgrade to new future releases 

□ Add new hardware 

Before you begin, it is best to read through the major sections of this manual and 
familiarize yourself with the terminology in Chapter 2. We use several conven¬ 
tions to make the directions clear and consistent Some of these conventions are 
UNIX! conventions, such as device names; others are simply Sun documentation 
conventions. 

Be sure to install your workstation hardware according to the procedures in the 
Sun Hardware Installation Manual. This will be critical for tire installation of 
the operating system onto your workstation. 


1.1. The Filesystem 

Reorganization Two major new features of Release 4.0 are the elimination of the Network Disk 

System partitioning and the reorganization of the filesystem. This new filesys¬ 
tem layout makes it easier for a single server to support many clients of different 
architectures, while still maintaining most of the f a mi l iar filesystem layout. 

The Sim Network File System (NFS) allows a computer with a local disk to act 
as a server by exporting its filesystems to clients on a network. The client com¬ 
puters may themselves be servers of other, local filesystems. A software architec¬ 
ture is defined by the hardware architecture that it supports and by its software 
release level. When a client and server have the same architecture they can share 
executables. 


t UNIX is a registered trademaik of AT&T. 
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The New Layout 


The Sun operating system has a lot of history buUt into the filesystem. There are 

numerous programs, shell scripts and makefiles that have built-in pathnames. In 

changing the layout of the filesystem, the basic goals of the rearrangement were: 

□ Provide easier maintenance of servers and clients. 

□ Allow easier mixing of remote and local filesystems 

□ Provide cleaner support of multiple architectures. 

□ Minimize disruption to existing programs from moving things around. 

□ Minimize symbolic link confusion. 

□ The directories /usr/acJm, /usr/spool, and /usr/tmp have been 
moved into /var and symbolic links point from the old names to the new 
location. For example, /usr/adm is now a symbolic link to / var/adm. 
The files /usr/lib/crontab and /usr/lib/sendmail. of have 
been moved to /etc and cron and sendmail have been fixed to 
look for them there. The sendmail. cf file tells sendmail where to 
look for aliases files and this has been fixed so that aliases are also in /etc. 

□ The executables in /bin have been moved to /usr/bin and /bin is 
now a symbolic link to /usr/bin. Similarly, the /lib files have been 
moved to /usr/liband /lib is now a symbolic link to /usr/lib. 

o The executables in /etc have been moved to /usr/etc with symbolic 
links were left in place for commonly used programs. The end of this 
chapter contains a list of the executables that were moved. 

□ A new directory, /usr/share, was added for files that can be shared 
across all architectures. It currently holds the manual pages (moved from 
/usr/man), the kernel object modules (moved from /usr/ sys), the 
SunView Programmers’ Source, and a few other files. Symbolic links were 
left behind in the original locations of most files and directories moved into 
/usr/share. 

□ The moimt points for home directories in the old filesystem layout were gen¬ 
erally sub-directories of /usr. We have moved them to a new directory, 
/home, so that the /usr filesystem can be mounted read-only, if desired, 
and so that a system administrator can export a /home directory that con¬ 
tains aU of the mount points for a whole network of servers’ exported home 
directories. This allows the owner of a client machine to either have a local 
/home directory which she maintains or to mount the standard /home 
directory which is updated by an administrator. 

□ A server which supports multiple architectures will have multiple copies of 
the/usr filesystem, one for each supported architecture. These are kept in 
the /export/exec directory and named according to the architecture 
supported. For example, the directory which contains executables for a Sun- 
2 running release 4.0 is called /export/exec/sun2. When a server is 
sharing executables with one or more of its clients the /export/exec 
entry for the shared executables will be a symbolic link to /usr. 
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There are a few rules to follow when writing or modifying programs that use the 

new filesystem layout. 

□ In general, /usr should be considered read-only and shared. It should con¬ 
tain only executables and libraries for a particular architecture. 

o The directory /etc contains the identity of a particular machine. You can 
think of it as the home directory of the machine. It contains aU of the text 
files that make up the administrative databases of the machine. It also con¬ 
tains directories that are used for per-machine files. 

□ There are two directories that are used for temporary files: / tmp and 
/var/tmp. The /tmp directory should be used for small files and quick 
access. These files are removed when the machine is rebooted. The 
/var/tmp directory should be used for larger and longer-lived files. 
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For a clearer picture of the file system changes between 4.0 and 3.X, compare the 
following directory trees. Wherever a string of arrows ( »»> ) appears after a 
directory name, this indicates a symbolic link to the directory following the 
arrows (eg.: /bin »»> usr/bin). 

Figure 1-1 SunOS 4.0 root Filesystem Directory 



1.2. SunOS 4.0 and 3.X 
Directory Structures 
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Figure 1-2 SunOS 4.0 /mst/ Filesystem Directory 
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-51ib 

- adm »»> ..A'ar/adm 

-bin 

-boot 

-demo 

-diag 

-diet 

-etc 

-games 

-hosts 
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-lib 

-local 
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Figure 1-6 SunOS 3X /-asr Directory 
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Booting Issues 


With the new filesystem layout, the executable that used to be on the root have 
been moved to /usr. This makes it necessary to change the way that booting 
single-user is done. 

In the old layout the root contained most of the executables that an administrator 
might need to repair a damaged system. This included programs like f sck, 
dump and restore for patching filesystems, and also included the C compiler 
and C library. The idea was to keep the root small (usually about 8 Megabytes) 
so that the chances of it getting corrupted are smaU, yet put enough utilities on it 
so that a corrupted machine can be rebuilt. 

Originally, the operating system executables were small so most everything 
needed could be put on the root and stiU have space left over for /tmp. In 
recent years, however, executables have grown in size due to the increased size 
of libraries that are linked in. This has made it difficult to keep aU of the useful 
executables on the root. 

By moving all of the executables to/usr and mounting/usr automatically at 
boot time we solve the problem of choosing which executables should be avail¬ 
able in single-user mode. They aU are. 

Unfortunately, to mount the /usr filesystem we need to have some executables 
on the root. The / sbin directory holds only those executables needed to mount 
/usr at boot time. The rc. boot shell script, which is executed at boot time 
by init, mounts the /usr filesystem, then checks both the root and /usr 
filesystems. 
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Table 1-1 Executables Moved From /etc to /usr/etc 


Original name 

name 

Type 

Symbolic link 

/etc/arp 

/usr/etc/arp 

file 

yes 

/etc/biod 

/usr/etc/biod 

file 

no 

/etc/chown 

/usr/etc/chown 

file 

yes 

/etc/clri 

/usr/etc/clri 

file 

yes 

/etc/chroot 

/usr/etc/chroot 

file 

yes 

/etc/cron 

/usr/etc/cron 

file 

yes 

/etc/dkinfo 

/usr/etc/dkinfo 

file 

yes 

/ etc/dmesg 

/usr/etc/dmesg 

file 

yes 

/etc/dump 

/usr/etc/dump 

file 

yes 

/etc/fastboot 

/usr/etc/fastboot 

file 

yes 

/etc/fasthalt 

/usr/etc/fasthalt 

file 

yes 

/etc/fsck 

/usr/etc/fsck 

file 

yes 

/etc/fsirand 

/usr/etc/fsirand 

file 

no 

/etc/getty 

/usr/etc/getty 

file 

no 

/etc/halt 

/usr/etc/halt 

file 

yes 

/etc/ifconfig 

/usr/etc/ifconfig 

file 

yes 

/etc/in.rlogind 

/usr/etc/in.rlogind 

file 

no 

/etc/in.routed 

/usr/etc/in.routed 

file 

no 

/etc/in.rshd 

/usr/etc/in.rshd 

file 

no 

/etc/inetd 

/usr/etc/inetd 

file 

no 

/etc/init 

/usr/etc/init 

file 

no 

/etc/in.rexecd 

/usr/etc/in.rexecd 

file 

no 

/etc/link 

/usr/etc/link 

file 

yes 

/etc/mkfs 

/usr/etc/mkfs 

file 

yes 

/etc/mknod 

/usr/etc/mknod 

file 

yes 

/etc/mount 

/usr/etc/mount 

file 

yes 

/etc/ncheck 

/usr/etc/ncheck 

file 

yes 

/etc/newfs 

/usr/etc/newfs 

file 

yes 

/etc/nfsd 

/usr/etc/nfsd 

file 

no 

/etc/portmap 

/usr/etc/portmap 

file 

no 

/etc/pstat 

/usr/etc/pstat 

file 

yes 

/etc/reboot 

/usr/etc/reboot 

file 

yes 

/etc/renice 

/usr/etc/renice 

file 

yes 

/etc/restore 

/usr/etc/restore 

file 

yes 

/etc/rpc.lockd 

/usr/etc/rpc.lockd 

file 

no 

/etc/rpc.statd 

/usr/etc/rpc.statd 

file 

no 

/etc/shutdown 

/usr/etc/shutdown 

file 

yes 

/etc/umount 

/usr/etc/umount 

file 

yes 

/etc/update 

/usr/etc/update 

file 

yes 

/etc/unlink 

/usr/etc/unlink 

file 

yes 

/etc/ypbind 

/usr/etc/ypbind 

file 

no 

/etc/ypserv 

/usr/etc/ypserv 

file 

no 
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Table 1 -2 Other Files and Directories 


Original name 

New name 

Type 

Symbolic link 

/usr/adm 

/var/adm 

directory 

yes 

/usr/preserve 

/var/preserve 

directory 

no 

/usr/tmp 

/var/tmp 

directory 

yes 

/usr/spool 

/var/spool 

directory 

yes 

/usr/lib/sendmail.cf 

/etc/sendmail.cf 

file 

no 

/usr/lib/aliases 

/etc/aliases 

file 

no 

/•Qsr/lib/crontab 

/etc/spool/cron/crontabs/root 

file 

no 
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Getting Started 


This chapter and the following one are devoted to helping ready your woikstation 
for the installation of Release 4.0. It is very important to read through this 
chapter and the Chapter 3 before you proceed. In this chapter you will be given 
instructions for loading a mini version of the operating system, formatting your 
disk and generally getting ready to use the new installation facility, suninstall. 
Chapter 3 is a complete explanation of how to use suninstall. You will need this 
information in order to use the Walkthroughs in Chapters 4 and 5 effectively. 

Release 4.0 is quite different from previous Sun releases. ND partitioning has 
been eliminated and the file system has been reorganized. With this new layout, 
you will be able to use the Sun Network File System (NFS) exclusively to sup¬ 
port different architectures. 

The following information will make it easier for you to understand the installa¬ 
tion procedures in this release. 


The following subsections describe terms used in the installation procedures, and 
provide necessary background information. 


Standalone 

A standalone workstation has a complete root file system and user file sys¬ 
tem on its disk; and does not require another machine to boot UNIX. It must 
have its own disk; it may or may not be attached to an Ethernet; and it may 
or may not have a local tape drive. But it does not rely on any other 
machines for storage. 

Server 

A server woikstation on a local netwoik provides resources like network ser¬ 
vices and disk storage for other machines, which are called “clients’ ’. For 
installation purposes, the term “server” means “network file server” that is, 
a machine which provides disk storage for its clients. Normally, a server 
uses the NFS (‘ ‘Network File System" — see n f s (4P)) protocols to 
exchange files with its clients. 

Diskless Qient 

A client woikstation on a local netwoik relies on a server for disk storage. 

To ‘install’ a diskless client workstation, complete installation on its 
server and then simply power it on. The only things you need to know 

sun 17 Revision A, of 9 May 1988 
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about the client for server installation are its name, hardware Ethernet 
address (see Networking Terminology, below), Internet address (see below), 
yeUow pages type, pathname of the root directory, pathname of swap, path 
name of the dump directory, pathname of the home directory, pathname of 
executables of client architecture type and disk space reserved for client for 
swap. 

Dataless Qient 

A dataless client workstation on a local network relies on a server for 
resources, such as files, but has its own disk storage. A dataless client can 
actually boot the operating system from its local disk but requires the user 
filesystem from a remote machine to come up single user and multi-user. In 
other words, some of its files are local, and others are remote. The remote 
files can be obtained from any machine running NFS. 

Networking Terminology If you are installing several machines linked by a local network, part of installa¬ 

tion includes basic network configuration. 

Hardware configuration must be completed first: each machine must have Ether¬ 
net controller hardware, and be ‘plugged in’ via a transceiver to a common Ether¬ 
net cable. For Ethernet hardware configuration instructions see the Hardware 
Installation manual for your machine model. 

Before proceeding with the installation, you must obtain basic information about 
the system’s place in the network. Some of the information items, like machine 
name, are arbitrary, and others are determined by hardware. 

For additional information on networking and tuning your configuration, see the 
Sun System Administration and Networking manual. 

Before proceeding with the installation, obtain, decide on, and write down all the 
items in the following list: 

Hostname 

(Also called "machine name"). Name the workstation. Although hostnames 
may contain up to 32 alpha/numeric characters, it is best to keep them brief. 
All alphabetical characters in a hostname must be lower case. Avoid the 
use of special characters. Assign each machine in your network a hostname. 

Ethernet Address 

Refers to the address which is permanently assigned to each workstation, 
and is used by the Ethernet software to decide which packets to deliver to 
that machine. The Ethernet address resides in the ID PROM on the Sun 
CPU Board. This address is a 6-byte hexadecimal value with each byte 
separated by a colon. A typical EAemet address is “8:0:20:0:14:76". 

To find a machine’s Ethernet address, power it on. You wUl see the Sun logo, 
and a message like: 
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If you do not intend to connect to a wider area networic, you may use Sim’s 
default netwoik number: 192.9.200. This number MUST be written with periods 
between the numbers. 


Internet Address 

A machine’s Internet address consists of two parts: the network number fol¬ 
lowed by the host number. For example, ‘ ‘ 192.9.200.45 ” is a typical Inter¬ 
net address consisting of Sun’s default netwoik number, “192.9.200”, fol¬ 
lowed by the host number “45”. See inet(3) man page for classification of 
networks. 

Domain Name 

The domain name identifies a group of workstations on a single local net¬ 
work that share some of the administrative files like /et c/passwd and 
/etc/hosts. Note that you only need a domain name if you want to link 
two local networks, and hostnames on the two nets are not unique — two 
hosts with the same machine name are distinguished by their domain names. 
You must have a domain name if you plan to use the yeUow pages. Without 
one the yellow pages will not work properly. Note also that this domain 
name has absolutely nothing to do with the domain name used by the 
sendmail(8) program for mail routing on the ARPA Internet. 

Tapehost 

A tapehost is a machine which has the tape drive that is used during a remote 
installation. 

Target Machine 

Dumg a remote installation, the target machine is the machine you are 
installing. 


Operating System 
Terminology 


SunOS™ 

SunOS™ is Sun’s UNIX based operating system incorporating Berkeley 4.2 
and System V. It wUl be referred to in this manual as the SunOS™ or the 
operating system. 

miniroot 

The miniroot is a very small version of the operating system loaded into the 
swap partition. The miniroot gives you just enough memory to install the 
overall operating system. 
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format 

format is a SunOS™ utility that enables you to fonnat, label, repair and 
analyze disks on your Sun system. For more information, see Chapter 11 of 
the System Administration and Networking on the Sun Workstation 

MUNIX 

MUNIX is a version of the operating system which is loaded from tape or 
over the network and does not require root or swap space on a disk. It is a 
useful tool when your local system disk is either corrupted or has never been 
formatted before. 


Abort Procedure As you proceed through this manual, there may be a need to abort certain pro¬ 

cedures. Listed below are "abort sequences" for Sun workstations. Familiarize 
yourself with the one that pertains to your workstation. 

To return to the PROM monitor at any time during installation, you can type 
what we call an abort sequence on your keyboard. The abort sequence usually 
consists of two keys typed in sequence; the first key is held down while the 
second key is typed. The keys vary with Sun Workstation model and keyboard 
type: 

□ If your Sun-1 keyboard has a 1 SET-UP 1 key, the abort sequence is 
[ SET-UP l a (hold down the I SET-UP I key while typing ‘a’). 

□ If your Sun-1 has an [ ERASE-EOFI key, the abort sequence is 

1 feRASE-EOFI a (hold down the I ERASE-EOF I key while typing ‘a’). 

□ On a Sun-2 keyboard, type 1 Ll-a. I (hold down the 1 LI I key in the uppermost 
left-hand comer while typing ‘a’). 

□ On a Sun-3 keyboard, type I Ll-a. I (This is the same as the Sim-2 keyboard.) 

□ On a standard terminal (if it is the console) the I BREAK I key generates an 
abort. 

2.3. SunOS Device Names The operating system has its own set of names for devices. These names are 

fairly arbitrary, but are often based on abbreviations for the controllers used to 
drive the devices. When the operating system boots up, it probes the system for 
the device and controller configuration and reports what it finds there. Since you 
will be using these names during installation and in most of your administrative 
dealings with the system it’s a good idea to identify your system’s devices at this 
point, and to remember their operating system device names: 
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Table 2-1 Tape Devices 


Devices 

Description 

ar 

Archive quarter-inch tape cartridge 

mt 

Nine-track magnetic 1/2" tape-Tapemaster controller 

St 

SCSI tape controller cartridge 

xt 

Nine-track magnetic 1/2" tape-Xylogics 472 controller 


Table 2-2 Disk Devices 


Devices 

Description 

xy 

Xylogics 450/451 SMD disk controller 

sd 

SCSI disk controller 

xd 

Xylogics 7053 disk controller 


Table 2-3 


Ethernet Types 


Type 

ec 

ie 

le 


_ Description _ 

3COM ethemet controller 

Sun-2, Sun-3/75, Sun-3/100, Sun-3/200 and Sun-4 ethemet controller 
Sun-3/50, Sun-3/60 and Sun-3/Eurocard ethemet controller 


In the walkthrough of the installation, when we ask you to type in your tape, 
disk, or ethernet name, you should type in the device name for the appropriate 
device. 


2.4. Determining Network 
Information 

NOTE The procedures in this section apply only to systems with Ethernet. If you 
do not have Ethernet, skip to the next section, Loading the Bootstrap Pro¬ 
gram. 

If you have an existing network that you do not intend to upgrade, you might 
need to make it compatible with the new network software. In any case, complete 
the steps given below for any machines you are installing or upgrading, and 
when you are finished, read the section How to Make Current Networks Compa¬ 
tible With Older Networks in the Sun System Administration Manual. 

Before beginning actual installation, you must know; 

1) The full Internet address (network number followed by unique host number) 
for each workstation you are setting up — whether it is a server or a client. 
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2) The hardware Ethernet address of each client machine if you are installing a 
server/clients configuration of machines, and 

3) The yellow pages domain name of the workstation or group of workstations 
you are installing. 

These items will be requested later during installation, but must be obtained now. 

Please remember that: 

□ You can use Sun Microsystems’ default network number (192.9.200) if you 
have not been assigned a iKtwoik number by ARPA, or if you are not con¬ 
nected to a higher level network. 

o You must have aU sets of distribution tapes if you are installing a hetero¬ 
geneous server. If you want this server to support Sun-2 Sun-3, and Sun-4 
hardware, you must also have Sim-2, Sun-3, and Sun-4 distribution tapes 
before you start. 

o You need a domain name if you are running the yellow pages, and there are 
duplicated hostnames or user id’s (the domain name simply distinguishes 
network nodes). If you have only one letcipasswd file and one letcihosts file 
for your organization (if there is a single unique user id and machine name 
space), the domain name is stiU necessary if you are running the yeUow 
pages. 

□ Obtain each client’s machine hardware Ethernet address by powering up the 
workstation, and checking the six-byte hexadecimal address displayed in the 
monitor power-up banner. When you turn the machine on, you’U see the 
Sun logo, and a message like the one in the example below. Abort immedi¬ 
ately when the machine begins to auto-boot; 

Self Test completed successfully. 

Sun Workstation, modeljype, keyboardjype 

ROM Rev N, somejiumberJdBytes memory installed 

Serial %somejiumber, Ethernet address xx:xx:xx:xx:xx:xx 

Auto-boot in progress . , , 

abort by typing the appropriate abort sequence here 

Abort at some address 

^ ’ . . j 

You will need the entire six bytes of the displayed Ethernet address later; 
copy them down. 


2.5. 


Loading the Bootstrap 
Program 


This section covers the first set of steps of actual installation: loading the distri¬ 
bution tape on your tape drive, and using ttie PROM Monitor to load the 
bootstrap program from tape. The bootstrap program is used to load other pro¬ 
grams from tape into memory. 
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What is on the distribution The software needed to load the operating system is contained either on three 

tape? half-inch magnetic tape reels, or on four quarter-inch tape cartridges. See the 

READ THIS FIRST for a complete listing of the files on the distribution tape. 

In order to help you with these steps, we have put the basic commands for a sim¬ 
ple walkthrou^ installation in the left hand margins of the following sections. 
However, these are only the basic commands. We recommend that you read this 
chapter in order to determine the type of system you are installing before using 
these commands since they may not meet your specific installation needs. 


Step 1: Loading the Tape 


1. Turn on the Sun Workstation which you are installing. 


Almost immediately, the PROM monitor displays its power-up baimer, which 
looks something like the example below, and then the machine begins to auto- 
booL Stop the auto-boot immediately by typing the appropriate abort sequence 
for your machine (abort sequences are described in Section 2.2 of this chapter). 
When you abort the auto-boot, you return control to the monitor, and it displays 
its prompt (>): 

r .'.—^—.■' ■ A 

Sun Workstation, modelJype, keyboardjype 

ROM Rev K, somejtmrd>erJdBytes memory installed 

Serial ^somejiumber, Ethernet address xx:xx:xic:xx‘Joc:xx 

Auto-boot in progress . . . 

abort by typing the abort sequence for your machine here 
Abort at somejtddress 

|||||||||ii||||l|||||||||||||M 


NOTE If you are re-installing an existing system, you will need to halt the system. To 
do this become super-user and type the command: / e t c / halt. Remember to 
halt all diskless clients if the system is a server. Full dump is strongly recom¬ 
mended before you halt the system. 

2. Load the tape. 

If you have any questions about your tape drive, see the subsystems chapter in 
the Hardware Installation manual for your machine. 

Step 2: Loading the Bootstrap If you are installing using a local tape drive, boot the general purpose bootstrap 

Program program from the tape by typing a b (for boot), followed by the two character 

device abbreviation for your tape drive type, followed by open parenthese, zero, 
comma, zero, comma, 0 and closed parenthese. For example: 

. ■ ^ . \ 

>b tape (Of 0,0) 

^ ^ _ / 
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In the following, please remember to substitute tiie proper device abbreviation 
for your tape controller for tape: ar for Archive 1/4” Tape Controller, st for 
SCSI Tape Controller, mt for a 1/2” tape controlled by a Tapemaster Controller, 
or xt for a 1/2” tape controlled by a Xylogics 472 Tape Controller. For more 
information on device abbreviations or conventions used in these procedures, see 
the table at the beginning of this chapter rmder General Information, Device 
Names. 

When you type the command, the monitor echoes it back to you, with the param¬ 
eters filled in. For example, loading the boot program from device xt: 
-- 

>bxt(O^,0) 

Boot: 


2.6. Using/ormat during 
System Installation 


NOTE The procedures described in this section are to be followed with extreme 

caution. Running format on your disk causes all the data on it to be erased. 
Before proceeding: 


Make at least one backup of the disk you intend to format, preferably two, 
since one of the tapes may be faulty. 

Make sure you have four megabytes of main CPU memory, as MUNIX 
requires that much to run. 


You may want to run memory diagnostics, just to be sure. 


It is sometimes necessary to run the format program when you install your 
system. In particidar, if your target system disk has been corrupted or was pur¬ 
chased from a third-party vendor, you will have to format and label the drive 
before you install the SvmOS. If the disk was purchased from Sun this is not 
absolutely required, as all disks sold by Sun are formatted and labelled at the fac¬ 
tory. However, with brand new drives straight from the factory, it is recom¬ 
mended that you reformat the entire drive anyway, as this insures that any head 
movement that occurred during shipment will not affect the performance of your 
new disk. Also, if you wish to partition your new disk differently than the Sun 
default partitions, you need to create a partition table and relabel the disk before 
proceeding with the installation. This section shows you how to use format to 
prepare your system disk in such situations. 


Before proceeding with examples, a note about MUNix is in order. MUNIX is a 
version of the SunOS that is loaded from tape or over the network and resides 
entirely in memory. It does not require a disk from which to load or swap and is 
therefore a very useful tool if your local disks are unformatted or corrupted. Run¬ 
ning format under MUNIX is about the same as running it under the SunOS, 
with a couple of exceptions. First, before running format imder MUNIX, you 
must create the proper entries for your device in the /dev directory or 
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format will not be able to access your disk. The /dev entries are not pre¬ 
made for you because there is no way to know exactly which devices you will 
need ahead of time. For this reason, you must boot MUNIX with the -asw 
flags so as to be able to create the entries. If you wish to modify and save files, 
you must perform the additional step of saving Ak files to a scratch tape, as 
MUNIX stores all its "files" in volatile storage (i.e. ramdisk). The following 
example shows you how to run format in the MUNIX environment 

In this example, you are installing xdO as your system disk. We will assume that 
the target didc is a Fujitsu 2333, that it was originally formatted by a Xylogics 
451 SMD controller, that you are upgrading to a Xylogics 7053, and that this is 
the only disk in the system. Such a situation requires MUNIX, because the two 
controllers are not format compatible, so the target disk must be reformatted 
before anything can be loaded onto it. 

To load MUNIX type the following. Note that tape device stl is used to initial¬ 
ize the ram disk. If your tape was in QIC-11 format (the tape label will tell you 
this), you would initialize from s 10. 

Boot-tape 0 

Boot:tope(0,0,4> -asw 


root filesystem type <spec 4.2 nfs) :4.2 
root cievioe (r(l% [a-h.J ;rd0a 
init ram disk from {stir stO] ttapeX 
Tape file nufnper? S 

Swap filesystem type <Spec 4.2 nfs): spec 
Swap device (ne%d[a-li]) :ns0a 

< _ ^ 

Next, enter format and select the disk you wish to work on: 
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r .... ....... 



# cd /dev 



# MAKEDEV xyO 



# foxxnat 



Searching for 

diska.*.done 


AVAILABLE DISK SELECTIONS: 


Ow xyO at xycO $lave 0 


xyO: <Fu5itsu-M2333 cyl 821 alt 2 hd 10 sec 67> 


Specify disk 

(enter its number): 0 


selecting xyO 

<Fujitsu'“M2333> [disk formatted. 


defect list found] 


di$k 

-- select a disk 


type 

- select (define) a disk type 


partition 

-- select (define) a partition table 


.current 

- describe the current disk 


format 

- format the disk 


repair 

repair a defective sector 


ahow 

-- Show a disk address 


label 

- label the disk 


analyze 

surface analysis 


defect 

defect list management 


backup 

-- Search for backup labels 


quit 



format > 



V 




At this point, note that the disk is already formatted and a defect list is present on 
it. This should ALWAYS be the case with disks shipped from Sun. If you do not 
see this message, something is wrong and you should immediately exit format 
and use diagnostics to locate the problem. 

Before we can reformat the target drive, we need to save its defect list to a safe 
place, since the 7053 caimot read the defect list off a drive fonnatted by a 451. 
Note that if your disk was purchased from a third-party or is missing its defect 
list for some other reason, you can use the extract command, which examines the 
disk and builds the defect list for it, based on which defects have been repaired. If 
you have a third-party disk that’s brand new, you can use the original command 
to read the manufacturer’s defect list that comes with aU SMD drives. These 
commands are explained hilly in chapter 10 of the System and Network Adminis¬ 
tration manual. Since you are going to have to switch off the power to install the 
new controller, you must save the defect list on non-volatile storage. In our 
example situation, we have to save the defect list to tape, since there is no other 
disk. The easiest and most reliable way to do this is the tar utility. Before 
saving the defect list, you should compare it to the hard copy of the 
manufacturer’s defect list. It should contain all the defects on the hard copy list. 

It may also contain some defects that were found at the Sun factory. If any of the 
defects are missing, you should use the add command to add them to the defect 
list before proceeding. 
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Note that we have put the serial number and model of the disk in the name of the 
defect file. This is always a good idea, as it lets you match up the defect file with 
the correct disk easily. If the serial number of the disk is not readily available, 
use some other unique identifier. 

Now that you have saved the defect list on tape, power off the system and install 
your new controller as per the instmctions in the hardware installation manual. 
Then boot MUNix in the same manner as before. Using tar, read the defect 
list back in. After making the appropriate entries in/dev, startup format. 
Note that we have to specify the disk type because the 7053 can’t read the label 
of a 451 formatted drive. 
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# tar xvf /dev/rstO 2333_defs.033537 

# cd /dav 

# MAKEDEV xdO 

# Cd / 

# forxnat 

Searching for disks., .done 
<CR> 

<CR> 

AVAILABLE DISK SELECTION: 

0. xdO at xdcO slave 0 
Specify disk (enter its number): 0 
selecting xyO <type unknown> 

disk - select a disk 

type “ select (define) a disk type 

partition select (define) a partition table 

current describe the current disk 

format -- format the disk 

repair - repair a defective sector 

show - show a disk address 

label - label the disk 

analyze surface analysis 

defect - defect list management 

backup -- search for backup labels 

quit 

format> typ^ 

0. Fujitsu"-2351 Eagle 

1. Fujitsu“M2333 

2. Fujitsu--23€l Eagle 

3. CMD EMD 9720 

4. Other 

Specify disk type (enter its number): 1 
selecting xdO <Fujitsu--M2333> 

[disk formatted, no defect list found! 


Now you must load in the defect list and commit it (i.e. make it the current 
defect list) and you will be ready to format the disk with the new controller. 
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Now we are finally ready to fonnat the current disk. The default values for the 
bounds of the format command will cause the entire drive to be refomiatted. 
Also, by leaving the surface analysis parameters in their default state, 2 passes of 
analysis wiU automatically be run on the disk when format completes. It is 
recommended that you allow this analysis to complete, in order to verify the 
integrity of the media. After the format operation has finished, make sure you 
relabel the disk with the label command. 
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If any defects are found during surface analysis, they win be automaticaUy 
repaired if possible. If the automatic repair did not succeed, you need to repair 
them manuaUy. See the section on “Repairing a Defective Sector” in chapter 10 
of the System and Network Administration manual for step-by-step instructions. 

If you are happy with the default partitioning of the disk, you are now done with 
format, and can continue your instaUation. If you wish to change the partition¬ 
ing of the disk, use the commands in the partition menu to create a table, making 
sure to run the label command afterwards to label the current disk. 


2.7. Loading the miniroot 


If you are using a local tape drive, boot the standalone copy program from tape, 
and use it to copy the miniroot from the distribution tape to your disk. 


>b tape(0,0,0) 

Boot:Wp«{0,0,2) 

Size: some number+some number+somejiumber bytes 
Standalone Copy 
From: tape (0,0,3) 

To (0,0,1) 

s_, 


Copying in the miniroot takes about four minutes using a half-inch tape, and 
about nine minutes using a quarter-inch cartridge. At the end of the copy, the 
copy program returns control to the bootstrap program: 


/- 

Copy completed somejtumber bytes 

Boot t 

A 




2.8. Booting the Miniroot 


Now that there is an operable miniroot on the disk, the bootstrap program can 
boot the miniroot from the disk. Because this boot is single user, you must 
specify the -a (for ask me) option on the boot command, and also the —s (come 
up single user) option. This is because the miniroot uses the swap partition. If 
you do not use -a, the system wiU not ask you if you want the swap partition and 
as a result you will not be able to load the miniroot. Because the default for load¬ 
ing the miniroot is read only you must specify -w in order to make the miniroot 
writable to the swap. Boot the system as follows: 
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Boot s disk (0,0,1) vnunlx 

Size: somejnumber+some_mimber+somejnumber bytea 

sun ONIX 4.0 (GENERIC) #ls Sat Jul ZS 10:30;42 PDT 1988 

Copyright (c) 1987 by Sun Microsystems, Inc. 

( .. .abouttwenty lines of cortfigus(dionmessages... ] 


2. As the miniroot comes up, it displays some messages about the 

configuration of the system on which it is running, and finally queries you, 
asking for its root file system. The root file system type at this stage is 
“4.2”, which has a special meaning to the miniroot. 



Now you are ready to invoke suninstall. Go to the next chapter for a com¬ 
plete explanation of suninstall Read Chapter 3 carefiiUy before you proceed 
to the individual walkthroughs in Chapter 4. 
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suninstall 


suninstall is the replacement fot Setup, Sun Microsystems system installation 
tool for 3.x releases, suninstall is a tool tiiat will help you install and maintain 
the 4.0 Operating System on Sun Workstations. It not only maintains all the 
existing functionalities of Setup but it also includes some new features besides 
fixing file problems in Setup. The new features are ; 

□ on-line help 

There is a new on-line help screen that you can invoke any where in sunin¬ 
stall for quick reference. 

□ repainting the screen 

By using IC!R-\I the screen will refresh itself. 

□ re-entrance 

You no longer need to re-enter all the information if you exit from the pro¬ 
gram. By restarting suninstall, all the information saved before exiting from 
the program will be displayed for you and you may change it as you wish. 

□ installation-interrupt 

If for any reason you need to stop the installation or change the information 
you entered, you can type (Ctrl-C 1 and restart suninstall. The information 
you entered will be displayed in front of you. 

D mixed types of distribution tapes. 

suninstall allows you to install any combination of distribution tapes. For 
example, you can build a heterogeneous server with a set of 1/2 inch Sun-2 
tapes, a set of 1/4 inch Sun-3 tapes and a set of 1/2 inch Sun-4 tapes. This 
makes the installation procedures more flexible and convenient 

□ dataless configuration 

suninstall builds not only a standalone configuration, homogeneous server 
and heterogeneous server but it also builds dataless configuration. The 
definitions of these system configurations are in Section 2.2. 
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□ mixed architectures 

Now you can install as many architecture types as disk space allows. In 3.x 
SunOS releases, a heterogeneous server is allowed to support only Sun-2 and 
Sun-3 architectures. In 4.0 SunOS, a heterogeneous server can support Sun- 
2 , Sun-3, Sun-4 and Sun386i if there is enough disk space available for the 
executables of all these architectures. 

□ standalone/server conversion 

You can now turn a 4.0 standalone system into a 4.0 server without taking 
down or rebuilding the system. By mnning the command 
setup_client , you can create a diskless client while the system is mn¬ 
ning in multiuser mode. You can also remove a client while the system is 
running in multiuser mode by running the command setup_client. 

□ standalone & homogeneous server conversion 

You can now turn a 4.0 standalone system or a 4.0 homogeneous server into 
a 4.0 heterogeneous server while the system is up and running in multiuser 
mode. By running the command setup_exec, the executables of the 
architecture specified will be loaded onto the system and the clients of that 
architecture can be created by running the command setup_client. 

3 .2. Overview suninstall is broken into two stages: the first stage is information gathering and 

the second stage is the installation, suninstall presents you with five different 
forms. Each asks you for information pertaining to a specific aspect of system 
configuration. When suninstall starts, it prompts for the system’s terminal type, 
and will put you in the information gathering stage by displaying the main menu 
on the screen. It is recommended that you edit the forms in the order in which 
they are listed in the main menu. When you have entered all of the information 
needed by select [start the installation], from the main 

menu, to begin the installation. 

suninstalVs on-line forms are very similar to paper forms or questionnaires; they 
are composed of items that ask for a particular piece of information. There are 
two item types: Text and Choice. 

□ Text items prompt you to type in information such as a name. In other 
words, "fill in the blanks". 

□ Choice items present you with a list of choices and ask you to select one ele¬ 
ment from the list. This is the equivalent of "Check the appropriate box". 

When each form on the main menu starts, you will see three regions on the 
screen: the top region consists of the title of the form and help guides for 
Text items: the middle region consists of the prompts; the bottom region 
consists of the message Are you finished with this form? 

[ y/n] . Depending on what you choose you will either exit the form or con¬ 
tinue and revisit the other choice items on it. When you start suninstall, it 
will prompt you for the local time zone. (See Appendix B of this manual for 
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a complete listing of world time zones.) Fill in the correct time zone. It will 
then display the Day of the Week, Month, Date, Hour, Minutes, Seconds, 
Time zone and ask you if this correct. Fill y if it is. If not, answer n and 
fill in the correct time based on the examples below. 

In this example: dd/mm/yy: 

dd stands for day of the month, nun stands for the month, yy stand for the 
year. 

In this example: hh; mm: s s am/pm: 

hh stands for hour, mm stands for minutes, ss stands for seconds, and 
am/pm stands for morning or afternoon. 

Now the system will display the new corrected date/time. If it is correct, 
answer y. If not answer n and repeat the procedure. 

After you have set the date you will be prompted for your terminal type. 
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# siminstaXI 


Enter the iocial time stone name: 


Is this the correct date/time [y/^3 • 

Day of the Weeh^ Months Date^ Hour, Minutes, Heeonds, Timessone 


Enter the current date and local time {e,g. 09/03/88 12:20:30), 
the date may be in one of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd-mm-yyyy 
dd^mm--yy 
month dd, yyyy 
dd month yyyy 

and the time may be in one of the following formats; 
hh am/pm 
hh;mm am/pm 
hh.mm 

hh;mm am/pm 
hh.mm 

hh:mm;ss am/pm 
hh:mm:ss 
hh.mm^ss am/pm 
hh.mm.ss 

» 09/03/88 12:20:30 (For example) 

Is this the correct date/time [y/nl; 

Wed Mar 9 12:20:30 PST 1988 (For example) 

||||||||||||||||||||||||;| 

Select your terminal type; 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 


If you select "Other", the name of the terminal must correspond to a name in the 
termcap database. 


Enter the terminal type (your terminal type must be in /eto/termc!ap}>> 


^ Jlf 
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3.3. Main Menu The main menu is displayed on the screen, putting you in the information gather¬ 

ing stage of suninstall. Below is an illustration of the main menu, as well as 
explanations of the items in the form. 

-^^ 


Sun Microsystems System Installation Tool 
Main Menu 

{ Please use x or X to select your choice 1 
( + means the data file(s) exist<s) ) 

[ assign host information ] 

I assign disk Information 3 

t assign software information 3 

[ assign client information 3 

I on-line help information 3 

C start the installation 3 

[ exit from suninstall 3 

[x/x=select choice3 lspace»next ohoice3 ['"B/''P~backward3 t"E'/''Nwforward3 

s_^_/ 


PROMPTS 


EXPLANATIONS 


assign host information Gather system specific information. The Host Form wiU be displayed if you 

select this choice. A "-h" will be displayed in front of this item if the data file(s) 
required by this form already exist. This usually occurs when you revisit the 
form. 

assign disk information Gather partition sizes for specified attached disk device(s). The Disk Form will 

be displayed if you select this choice. A"+" will be displayed in front of this 
item if the data file(s) required by this form already exist. This usually occurs 
when you revisit the form. 

assign software information Gather software categories to be extracted for the architecture type specified. If 

you are installing a dataless configuration, you will not be allowed to select any 
software since the system wiU be sharing /usr with the server and only 
required software categories wiU be loaded for instaUation purposes. A"+" wiU 
be displayed in front of this item if the data file(s) required by this form already 
exist. This usuaUy occurs when you revisit the form. 
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assign client infonnation 

start the installation 
on-line help infonnation 


exit from suninstall 


Gather client infonnation. The Qient form wiU be selected if you select this 
Choice. If you are NOT installing a server, you will NOT edit this form. A "-h" 
will be displayed in front of this item if the data file(s) required by form already 
exist. This usually occurs when you revisit the form. 

Start installation. 

produces the following help screen: 


( -:- 




KEYS 

PURPOSE 

CONTROL F 

move cursor forward 

CONTROL N 

move cursor forward 

CONTROL B 

move cursor backward 

CONTROL P 

move cursor backward 

CONTROL U 

erase word 

<DELETE> 

erase cue character 

CONTROL S 

repaint screen 

CONTROL C 

abort 

<RETDRN> 

end of input string 

Are you finished with this 

^ . .... 

form ty/n3 t 

j 


Exit from suninstall. When you exit suninstall you return to the directory where 
you loaded suninstall, usually /usr/etc/install. 

When you exit from suninstall, it saves a copy of ever54hing you have completed 
up to that point. Later when you re-invoke suninstall you wiU start where you 
left off. You do not have to re-enter previous infonnation. 
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3.4. Host Form 

Below is an illustration of the Host form, as well as explanations of the prompts it contains. This is generally the first 
form to be filled out 


HOST FORM [Dltli«erase one char of inpuh dahaj [KETnend of inpuh daha} 


Workstation Information : 

iiiiiiliiiiilliiiiiiliiiiliiiiiiiiiliiiiiiii® 

Type : fstandalonel Jserverl fdatalessl 

Server Name ; 

Server internet Address : 

Path of the executables on server: 

Network Information : 

Ethernet Interface : Cnonel tinterfaceO] finterfacell 

Internet Address 0 ; 

Internet Address 1 : 

yp Type ; Cnonel tiRaster] [slave] [client! 

Domain name : 

Misc Information : 

Operation type : [install] [upgrade] 

Reboot after completed : [y] [n] 


Are you finished with this form fy/n] ? 

[x/X~5elect choice] [space^next choice] [''B/''Rs»backwardl ["f/'N^forward] 

t- .. , ' J 


PROMPTS 


EXPLANATIONS 


Name 


Hostname of the system. 


Type Refer to Chapter 2 if you are not familiar with the differences between listed 

types. 

Server Name Name of the system that will be serving /usr to this system. This prompt will 

be displayed only when installing a DATALESS configuration. 


Server Internet Address 


Internet address of the system that will be serving /usr to the dataless system. 


Path of the executables on 
server 


For DATALESS configurations, this is the path for the executables on the server. 


Ethernet Interface Select [none] is you do not want the system to be on the network. If you want 

the system to be on the network, you should go through all the Ethernet inter¬ 
faces and assign the appropriate Internet addresses for each interface. 
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Internet Address 0 
Internet Address 1 

YPType 
Domain name 
Operation type 


Internet address of the first Ethernet interface if there is an Ethernet interface. 

Internet address of the second Ethernet interface if there is second Ethernet inter¬ 
face. This will only appear on the screen when there is more than one. 

YP master server, yp slave server, yp client or not using yp. 

YP domain name 

Full installation to a major release or an upgrade of a minor release (4.0 and post 
4.0 releases only). 


Reboot after completed Y means the system will be rebooted after installation is completed, n means 

the system will remain in the miniroot environment after installation is com¬ 
pleted. 


Are you finished with this form Entering y will save the entered information and return you to the Main menu, 

[y/n] ? Entering n will return you to the top of the form. 
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3.5. Disk Form 

Below is an illustration of the Disk form, as well as explanations of the prompts it contains. 


/- 

DISK FORM 

[DEI^erase one char of 

input data] [RETsend of 

input data] 

-\ 

Attached Disl? 

Devices t 




[disJcO] [disk } [disk 3. 




Disk Label: 

[default] resisting! 

[label in data file] 



Free Hog Disk Partition : [a] Id] 

te] [f] tgl th3 



Display Unit 

: [Mbytes] 

[Kbytes] tbytes] [blocks] [cylinders] 


PARTITION START_CYL BLOCKS SIZE 

MOUNT PT 

PRESERVE(Y/N) 


a 0 

15884 7 

/ 

n 


b XX 

33440 16 




c 0 

140624 68 




d 0 

0 0 




e 0 

0 0 




f 0 

0 0 




g XX 

91256 44 

/usr 

n 


h 0 

0 0 




Ok to use this partition table ly/n] 




Are you finished with this form ly/n] ? 



[x/X=aelect choicel Ispace=next choice! ["B/"P«backwardJ 

[ "F/"‘N=forward] 






y 


PROMPTS 


EXPLANATIONS 


Attached Disk Devices 
Disk Label 


Free Hog Disk Partition 


Display Unit 


Attached disk devices will be displayed in this area. 

[default]= default partition table 

[existing]= existing label on the disk. If you select this, there is no preservation 
of the file system mount points. 

[label in the data file]= information saved from the previous edit. 

Select the partition that has enough extra space to give to other partitions. Also, 
this partition is where extra space is stored if you free up disk space in suninstail 
as well as where it will be taken from when you increase a partition size. 

All numbers under SIZE column will be converted and displayed with the unit 
specified. 


PARTITION 


This choice item is where you actually partition your disk. There are some fun¬ 
damental concepts you need to consider when using this form. 
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START_CYL 

BLOCKS 

SIZE 

MOUNTPT 
PRESERVE (Y/N) 


The basic unit of the disk is the sector. Sun disk sectors contain 512 bytes of data 
space. Sectors radiate outwards from the center of the disk. The data space is 
further separated into concentric circles, called tracks, which pass through aU the 
sectors on the disk. On drives with multiple disks, tracks which occupy the same 
location on two or more disks are referred to as cylinders. 

Each disk has a maximum of eight hard partitions, by convention, labelled "a" 
through "h". These hard partitions create separate physical sections on the disk. 
Note that disks do not have to use all of the available hard partitions. 

Each hard partition has an offset and a size. Hard partition offsets must be in 
cylinders, but their sizes may be in either cylinders or sectors. For performance 
reasons, hard partition sizes are usually also in cylinders. Overlapping hard par¬ 
titions cannot be used by Unix simultaneously and so are not allowed by sunin- 
stcdl. 

The configuration of the hard partition is encoded within the disk label. The label 
is written to special locations on the disk by format (8) programs and can be 
changed by suninstall. The label is read from the disk by the SunOS at boot time 
to determine the disk configuration. You can see the existing label by using 
format’s verify command, or the command dkinf o(8) in the OS. 

Creating or changing disk labels should be done with caution. If the disk label 
needs to be changed after Unix is installed, all of the information on the disk 
should be saved before modifying the label. Changing a hard partition’s size or 
offset effectively destroys all of the information contained on that partition, and 
possibly other partitions as weU. 

The first three partitions must be labelled using the format program. 

a: system’s root/root partition for the server 

b: swap space (where the miniroot is loaded) 

c: the whole disk 

The partitions “d” through “h” are free space and can be labelled and have their 
sizes changed using suninstall. 


The starting cylinder for each partition. 

The system automatically fills in this information. 

The user fills in the size and then the system changes the BLOCK size automati¬ 
cally. 

File system mount point. 


Entering y will save the disk partition and install the software on top of the exist¬ 
ing files. Entering n will clean up the partition before installation. 
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Ok to use this partition table The data will be saved and used to label the disk, 

[y/n] ? 

Are you finished with this form Exit from this form. 

[y/n] ? 



Revision A, of 9 May 1988 



46 Installing the SunOS™ 


3.6. Software Form The Software form is illustrated below, along with explanations of the prompts 

displayed in it. This form is required for aU system configurations. As you work 
your way through these categories if you have not allocated enough space, 
suninstall automatically goes to the freehog space, taking what it needs to 
load your software choices. Thus this decreases the freehog space, and increases 
the partition you have chosen for the software. You will notice that there are 
considerable pauses between categories. 

NOTE Be sure to choose the install optional software if you are planning to con¬ 
vert your standalone system to a server later, or planning to add clients. The 
install software includes utilities you will need for adding clients. 


SOFTWARE FORM [DEL=«rase one char of input data] [RET=end of input data] 


Architecture Infcntiation ; 

Type : [sun23 [sun33 [s'(an4] 

Rath where executables reside ; 


[Sun386il 


Tape Infcntiation 
Device Type 
Drive Type 
Tapehost 
Tapehost's Internet Address : 


[arO] Iar8] tstO] tst83 CwitO] {xtO] 
[local] [remote] 


Choice 


[all] [default] [own choice] [required] [quit] 


CATEGORY 


NAME 


BYTES AVAIL BYTES Y/N 


Are you finished with this form [y/n] ? 

[x/X=3elect choice] [space=next choice] ['‘B/''P“backward] ["F/'N^fOrward] 


PROMPTS 


EXPLANATIONS 


Type Architecture type of the executables. 

Path where executables reside Directory where the executables reside (e.g. if path is specied, path/ sun2 

wiU be the directory of the Sun-2 executables), path must start with a /. 


Device Type 


Tape device 


microsystems 


Revision A, of 9 May 1988 






Chi^ter 3 — sunmstall 47 


Drive Type Tape drive type 

Tapehost System with the tape drive 

Tapehost’s Internet Address Internet address of the tapehost 

Choice [all] means load all of the software categories from the distribution tape(s). 

[default] means load aU of the common software categories the distribution 
tape(s). 

[own choice] means load all of the required software categories onto the dis¬ 
tribution tape(s), and then it prompts you for the optional software categories, 
[required] means load only the required software categories onto the distribu¬ 
tion tape(s). 

[quit] means exit from the form. 

If you are installing a heterogeneous server, you will be prompted to change 
types for various architectures. Then you will have to go back through and 
answer the questions that pertain to the architectures you have selected. 

CATEGORY, NAME. BYTES, Each software category will be displayed in this area. All required categories will 

AVAILABLE BYTES, Y/N have y under Y/N and required under CATEGORY. If the category is 

optional, the word desirable will appear under CATEGORY instead. You 
will have to answer y or n under Y/N for these optional categories. When you 
select a category, its size is automatically filled in under BYTES. AVAILABLE 
BYTES will also fill in what free space you have left. If you run out of available 
space, suninstall will automatically increasse the size of the partition by taking 
space from the freehog partition. You will see "from freehog" under the field 
AVAIL BYTES. 

When you have selected all the optional software you want, suninstall will list 
what you have selected and ask you if it is correct. 


Are you firushed with this form? Entering y returns you to the main menu. Entering n leaves you in the current 
y/n form. 
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3.7. Client Form Below is an illustration of the Qient form, as well as explanations of the prompts 

it contains. This form is only required when installing the server configuration. 


— 

CLXEhTT rOBH CDFLserase one char of input data] 

[RETsend of input data] 

ArOllitecturO Typ^ : [Sun2] ISun4J [Sun386i] 

Choice ; Ccreatel [delete] 

[display] [next arch] 

Client{s} : 


Client Information : 




Internet Address 


Etiiernet Address 


yp Type : [none] [master] [slave] [client] 

Domain name 


Path of Client^s Root 


Path of ClientSwap 


Path of ClientExecutables 


Path of ClientHome 


Swap size (e.g. 8M,8m,8K,8k,8 or 8b) ; 

Are you finished with this tontL [y/nj ? 


[x/x*=select choice] [space-next choice] 

t''B/*P’=backward] [*F/"N=forward3 

V . 



PROMPTS 


EXPLANATIONS 


Architecture Type 
Choice 


Client(s) 

Name 


Architecture type of the client 

[create] displays default client data and expects you to assign the client host- 
name and related informatioa 

[display] displays information for the specified client or an error message if 
the client does not exist. 

[delete] deletes the specified client or displays an error message if the client 
does not exist. 

Client(s) of specified architecture type will be displayed in this area. 

Client hostname 


Internet Address 


Client ip address 


Ethernet Address 


Client Ethernet address (If you are running YP and have the correct Internet 
address, you can use a dummy Ethernet address for file client. This is because 
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the system is only interested in the host ethemet address.) 

YP Type YP master server, yp slave server, yp client or not using yp. A diskless client usu¬ 

ally is never a yp master server. 


Domain name YP domain name. 

Path of Client’s Root If path is specified, /path/client name is the root directory of the specified 

client 


Path of Qient’s Swap 


If path is specified, /path/ client name is the swap file of the specified 
client. 


Path of Qient’s Executables If path is specified, /path/arch or /usr is the directory where executables 

will be mounted from the server. 

Path of Qient’s Home Home directories. 

Swap size Swap reserved for the specified client. These sizes are specified in megabytes, 

kilobytes, or blocks. The default is megabytes, (e.g. 
16M,16m,16000K,16000k,16000000 or 16000000b) 

Are you finished with this form? y allows you to exit from the form, n takes you back to the top of the form. 

[y/n] 

3.8. Installation Once you select [ start the installation ] in the main menu of 

suninstall, installation begins. You will be prompted when the tape needs to be 
changed. You can abort the installation any time by using [ Ctrl-C. I Before you 
restart suninstall, you should make sure no disk partitions are mounted. You can 
reassign information by starting suninstall and the information you entered will 
be displayed for you. You have the option of changing a portion of the informa¬ 
tion without entering everything all over again, or the option of changing all the 
information if you wish. Installation wiU begin once you select [ start the 
installation ] in the main menu of suninstall and the system will be built 
according to the latest information entered by running suninstall. You no longer 
need to abort the system, reload miniroot, and reenter aU the information when 
you need to stop the installation. If you select the reboot option in the Host Form, 
the system will be rebooted after the installation is completed and the system will 
be in multiuser mode with the following prompt on the screen when it is ready 
for use. 



If you do not select the reboot option in the Host Form, the system will remain in 
the miniroot after installation is completed and the following messages will be 
displayed on the screen. 
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Sy;5tem Installation Con^leteci» 

l^eboot your system and configure a kernel for your system. 

V_ J 


You can bring up the system by aborting and then booting the system. Refer to 
Chapter 2 for the abort sequence. 


- . 

> b 

V_ i 


If the system is either a yp master server or yp slave server, you need to set up 
the yp database after the system comes up in multiuser mode. Details of instal¬ 
ling and maintaining yp databases are in the System Administration and Network¬ 
ing manual. 

H 2 "Installing a root password" 

After you bring up your new system for the very first time, you may want to add 
a root password. REMEMBER!!!! ONCE A PASSWORD IS GIVEN TO 
ROOT, YOU CAN NOT LOGIN AS ROOT AGAIN WITHOUT GIVING 
THE CORRECT PASSWORD . To add a password do the following; 


login; root 
# passwd 

{The system will prompt you for your new password ] 


If you are upgrading or reinstalling an existing system, then there is probably 
already a root password in the /etc/passwd file. This file wiU (probably) 
be restored as part of the upgrade reinstallation. Again, if there isn’t one, just do 
the above after you reboot the system. 
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Walkthroughs 


4.1. Introduction 

This chapter offers you a series of walkthroughs for installing various system configurations with a local tape drive. 
Pick the example that most closely resembles the system you want to install. You do not have to configure your sys¬ 
tem exactly as shown. These are simply examples to help you design your own system configurations. 

□ Standalone Configuration 

□ Homogeneous Server 

D Heterogeneous Server 

□ Dataless Configuration 

At the beginning of each system type there is a list of assumptions about the system on which the example walk¬ 
through is based. Pick the example that most closely resembles the system you want to install. You do not have to 
configure your system exactly as shown. These are simply examples to help you design your own system 
configurations. Read the example you choose completely BEFORE you proceed to use it to install or modify your 
system. 

At any time during the installation procedures you need help, you can call up the On-Line Help screen by exiting the 
form you are in using. To do this, simply go the bottom of the form, answer yto Are you finished with 
this form [y/n] ?. This brings you back to the Main Menu. Now select on-line help information. 
The following screen will appear: 
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ON-I.INE HELP 


KEY3 

PURPOSE 

CONTROL F 

move cur 3 Or forward 

CONTROL N 

move cursor forward 

CONTROL B 

move Cursor backward 

CONTROL P 

move cursor backward 

CONTROL U 

erase word 

<DELETE> 

erase one character 

CONTROL \ 

repaint screen 

CONTROL C 

abort 

<RETURN> 

end of input string 

finished with thia 

form {y/n] ? 


When you are finished with this form, simply exit and return to the form you were in previously. 


4.2. Standalone Configuration With Local Tape Drive 

Assume you have a standalone system with the following descriptions; 

hostname; evans 
architecture; sun2 
ethemet interface; ieO 
system type; standalone 
internet address; 192.9.90.64 
local SCSI tape drive; stO 
1 Xylogics eagle disk; xyO 
yp client of domain "wseng.sun.com" 
software categories; all 

1. Become super user and do a full dump of your system. 

2. Halt the system by doing the following; 


--:-\ 

evans #/etc/halt 

V-. . . i 

3. If you are installing this release on a new disk that does not have a label yet; or if you wish to change the size of 
the root partition; or reduce the size of the swap partition, load MUNiXandrun format to label your disk. If 
you do not wish to change the existing disk label, skip this step and go to the next one. 
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5. Start suninstalh 

-__________ ^ 

# cd /usr/etc/install 

# 3unin$txall 

Enter the local time zone name: 

» US/Paci£ic 

Xs this the correct date/time [y/nj: 

Hon Mar X4 08:08:57 1988 

|||||||||i|:;Sii;|||||i;||||||||;||||||||||||||||||||||||^ 

Enter the current date and local time (e.g. 09/03/88 12:20:30); the date 
may be in one of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd-ram-yyyy 
dd-mm^yy 
month ddr yyyy 
dd month yyyy 

and the time may be in one of the following formats; 
hh am/pm 
hh: mm am/ pm 
hh.mm 

hh:mm am/pm 
hh.mm 

hh:mm:ss am/pm 
hh:mm:ss 
hh^mm.ss am/pm 
hh.mm.ss 

» 09/03/88 12:20:30 

Is this the correct date/time [y/nJ: 

Wed Mar 9 12:20:30 PST 1988 

;||||||||||||||||||||| 

Select your terminal type: 

1) Televideo 92S 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

|||||||i;||||i||||||||||||||||||||||||||||||||^ 

V___> 

The following menu will now appear: 
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Sun MicrosyBtems System installation Tool 
Main Menu 

{ Please use x or X to select your choice > 
( 4 means the <iata file(s) exist(s) ) 

[ assign host information J 

[ assi^rii disk information J 

[ assign software information J 

{ assign oliont information ] 

[ on--line help information J 

{ Start the installation J 

[ exit from suninstall J 


[x/X^S’O^lOCt ChoicOj (SpaOO*next ohoical ["^B/^P^hackwardl l^Fy"N“fOrwardl 
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6. Assign host infonnation by selecting [assign host information] in the Main Menu and the Host Fonn 
will be displayed on the screen: 


f 

- — . 

HOST FOHM [DEt=dr*se one cshar of input data] {RBT=end of input data] 

Workstation Infojmtation ; 


Name : evans 


Type ; *[standalone] 

[server] [dateless] 

Network Information : 


Ethernet Interface t 

fnone] x[ieO] 

Internet Addreas 0 : 

192.d.dO.S4 

yp Type t 

[none] [master] [slave] x[client] 

Dome inname : wseng. sun . com 

Misc Information : 


Operation type 

: xCinstall] [upgradel 

Reboot after completed : x[yl fnl 

Are you finished with this 

form ty/n] ? y 

t3£/X=*select choice] [space^next choice] [''B/''P-backward3 pp/'N^forward] 


. . j 


The main menu will be displayed on the screen after you answer "y" to the last prompt of this form: Are you 
finished with this form [y/n]?. 



sun 

microsystems 


Revision A, of 9 May 1988 




Chapt«4— Walkthroughs 59 


7. Assign disk information by selecting [assign disk information] in the Main Menu and the Disk Form 
will be displayed on the screen: 


r 




A 

DISK FORM [DEL=eirase one chair of 

Attached Disk Devices : 

input data} 

[RE^T^end o£ input data] 


*l xyO] 





Disk Dabel 

; *rdefauXt] 

[existing] 

[label in data file] 


Free Hog Disk Partition : tal [d.] 

[e] [f] x(gl 

th] 


Display Unit 

; X[Mbytes] 

[Kbytes] [bytes] [blocks] [cylinders] 


PARTITION START_CYli BLOCKS SIZE 

MOUNT RT 

PRESERVE(Y/N) 


a 0 

14336 7 / 

|||||||||||i||||||^|:|||||||||^ 


b XXX 

14336 70 




c 0 

262729 128 




d 0 

0 0 




e 0 

0 0 




f 0 

0 0 




g XXX 

105024 51 

/usr 



h 0 

0 0 




Ok to use this 

partition table [y/n] 

7 y 



Are you finished with this form [y/n] 

? y 



Cx/K-select 

choice} [ space—next choice] [ "'B/ ''P-backwardJ {"F/ "N-forward] 






, . ^ 


The numbers under the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers will be 
different for each disk and they depend on the existing label on the disk specified. The main menu will be displayed 
on the screen when you are finished with the form. 
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8. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form will be displayed on the screen: 

NOTE 


If you are planning on converting your standalone system to a server later, select the install optional software. 
It contains utilities that you will need later to convert your standalone system to a server and add clients. 


— 

SOFTWARE FORM IDBI.*«rase 

one char of input data] [R£T=:end of input 

A 

data] 

Architect tire Information : 





Type :x[sun2] 

[sun3] tsun41 [Sun386i] 


Path where executables 

reside ; /usr 




Tape Information : 





Device Type : farO] 

[arS] xlstO] 

[st8] [mtO] 

txtO] 


Drive Type : x [local] 

[remote] 




Choice : x[all3 

(default] (own choice] 

[required] 

(quit} 

CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 

required 

root 

XXXX 

xxxxx 

Y 

required 

Sys 

xxxx 

xxxxx 

y 

required 

user 

XXXX 

xxxxx 

y 

desirable 

Networking 

xxxx 

xxxxx 

y 

Are you finished with this form [y/n] ? 




[x/X=select choice] [space=next choice] 

["‘B/’"P=backward] ['"E/''N=forward] 
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The list of categories to be extracted for the sun2 architecture will now be displayed and the Software Form will look 
like the following: 


-—-- > 

SOFTWARE FORM [DEL=era3e one chai: of input cUtta] [KET=end of input data] 

Architecture Information : 

Type :xtsun2] [sun3] [sun4] [Sun386i] 

Rath where executables reside :/u5r 

Tape Information : 

Device Type : [arO] [arS] x[st01 {st83 [mtO] (xtO] 

Drive Type : x{local] [remote] 


Choice : x{all] (default] (own choice] (required] [quit] 


Extract list: 

root 

sys 

user 

Networking 

Debugging 


Are you finished with this form [y/n] ? y 

(x/X-select choice] [space-next choice] ("B/"'P-backward] ["F/"N-forward] 

<_____ J 


The main menu will be displayed on the screen when you are finished with this form. 
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9. Start the installation by selecting [ start the installation ] in the Main Menu and you will be 
prompted when the tape needs to be changed. If any information is missing, the installation will not start and the 
Main Menu will be displayed on the screen. You can abort the installation any time by using ( CTRL-CI and 
either restart it by using existing information or reassign information before restarting the installation. You 
should see the following messages after the installation begins. 


/-V 

System Installation begin : 

Label disk{s) : 
xyO 

File systems check : 

/dev/rxyOa: 140S24 sectors in 752 cylinders of 11 tracks^ 17 sectors 

7240Mb in 47 cyl groups <16 c/gr l^SSMb/g, 640 i/g) 
super-block backups {for fsck -b#) at: 


32, 3056, 6080, 9104, 

12128, 

15152, 

18176, 

21200, 

24224, 

27248, 


30272, 

33296, 36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976, 

60000, 

63024, 66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216, 


a lot of text 


** /dev/xyOa 

** Currently Mounted on /a/ 

Phase 1 - Check Blocks and Sizes 
Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
Phase 5 - Check Cyl Groups 

/dev/rxyOa: 516 files, 2575 used, 4896 free {16 frags, 610 blocks) 
Rebooting the system 


evans login; 

k___> 


10. Configure a kernel for your system. Refer to Appendix A for instructions on how to configure a kernel. If you 
wish to set a root password, see Chapter 3, Installing a root password . 
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4.3. Homogeneous Server With a Local Tape Drive 

Assume the following system configuration: 

hostname: evans 

ethemet interface: ieO 

architecture: sun2 

system type: homogeneous server 

sun2 client(s): Sofia and frodo 

frodo’s internet address: 192.9.1.1 

frodo’s ethemet address: 8:0:20:1:00:00 

Sofia’s internet address: 192.9.1.1 

Sofia’s ethemet address: 8:0:20:1:00:01 

internet address: 192.9.1.189 

local SCSI tape drive: stO 

1 Xylogics eagle disk: xyO 

yp slave server of domain "wseng.sun.com" 

software categories: required 


1. Become supemser and do a full dump of your system. 

2. Halt the system by doing the following: 



3. If you are installing this release on a new disk that does not have a label yet; or if you wish to change the size of 
the root partition, load MUNixandrun format to label your disk. If you do not wish to change the existing 
disk label, skip this step and go to the next one. 


r -----^--- 

>b BtO 

Boot :8t (Or Of 4) -^asw 

A 

root filesystem type (spec 4.2 xifs) :4.2 
root device {rd%d[a-Ii] :i:dO^ 
init ram disk from: stOa 
tape file ntimber?5 

swap filesysystern type (spec 4.2 nfs> :spec 
swap device (ns%d[a~h3 :nsOa 


# format 


Abort when you are done^ 
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4. Load the miniroot: 

---V 

>b atO 

Boot; at(0,0,2) 

Front; at (0,0,3) 

To; xy(0,0,l) 


Boot: 3qr(0,0,l)'viDunlx -aaw 

root filesystem type ( spec 4.2 nfs):4.2 

root device (xy%d{a«h))ixyOb 


swap filesystem type (spec 4.2 nfs): spec 
swap device (xy%d[a-h3 ;3qr0b 
Swapping on root device?y 


^ _:_;_ j 
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5. Start suninstall: 

/-^-N 

# cd /usr/etc/inatall 

# 3uninat:al.X 

Entex: the local time zone name: 

» UiS/Pacific 

Is this the correct date/time ty/nj: 

Hon Mar 14 08:08:57 PSl* 1^88 

Enter the current date and local time (e.g. 09/03/88 12:20:30); the date 

may be in one of the following formate: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd-ram-yyyy 
. dd-^mm^yy 
month ddr yyyy 
dd month yyyy 

and the time may be in one of the following formats: 
hh am/pm 
hh:iRm am/pm 
hh .mm 

hh:ram am/pm 
hh.mm 

hh:mm:ss am/pm 
hh:mm:ss 
hh^mm.ss am/pm 
hh.ram.ss 

» 09/03/88 12:20:30 

Xs this the correct date/time [y/nj: 

Wed Mar .9 12:20:30 PST 1988 

Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 


The following menu will now appear. 
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Sun Microsystems System Installation Tool 
Main Menu 

i Please use x or X to select your choice ) 

( 4 means the ciata fiie(s) exist (s) ) 

[ assign host information J 

I assign disk information J 

{ assign software information J 

I assign client information J . 

{ on--iine help information ] 

[ start the installation ) 

[ exit from suninstall 3 

{x/X=select choice J (5pace=*iiext choice! ['‘B/"P®=backward] [""F/"N=®fOrward3 
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6. Assign host infonnation by selecting [assign host information] in the Main Menu and the Host Fonn 
will be displayed on the screen; 


HOSf FORM 


[DEIi=^rase one char of input data] [KlST=en<l of input data} 


Workstation Information : 

Name : evana 

Type : [standalone] xlserverl [dataless] 


Network Information : 

Ethernet Interface : [none] xCieO] 

Internet Address 0 : 192.9.1.189 

YE Type : [none] [master] x[slave] [client] 

Pomainname : wseng.sun.com 

MisG Information : 

(iteration type t x[install] [upgrade] 

Reboot after completed : [y] x[n] 


Are you finished with this form [y/n] ? y 

[x/X=select choice] [space=next choice] ["B/"P“backward] f'‘F/'^N=forward] 


The Main Menu wiU be displayed on the screen when you are finished with this form. 
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7. Assign disk inforaiation by selecting [assign disk information] in the Main Menu and the DiskFonn 
win be displayed on the screen: 


DISK FORM 

[DEIis^xase 

one char of input data] [RET=end of input data] 

Attached Disk 

Devices ; 




act xyOl 






Disk lisbel 


[default] 

[existing] (label in 

data file] 

Free Hog Disk 

Partition : 

[a] [d] 

[e] [f] x[g] th] 


Display tJnit 

: X[Mbytes] 

[Kbytes] [bytes] [blocks] [cylinders] 

PARTIWON 

START_CYh BLOCKS 

SIZE 

MOUNT FT 

preserve (X/N) 

s 

0. 

15884 


/ 


b ^ . 

XXX 

33440 

16 



c 

0 

140624 

68 



d 

XXX 

XXX 

0 

/export/root 


e 

XXX 

XXX 

0 

/export/swap 


f 

0 

iiiiliiliiilliilii 

0 



g 

XXX 

91256 

44 

/export/exec/sun2 


h 

XXX 

XXX 

XXX 

/home 


Ok to use 

this 

partition table [y/n] 

7 y 


Are you finished with this 

form ty/n] 

? y 


[x/X“select 

V 

choice] (space-next choice] -backward] 

["F/‘N^forward] 


The numbers under the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers wiU be 
different for each disk and they depend on the existing label on the disk specified. The main menu wiU be displayed 
on the screen when you are finished with the form. 
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8. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form wiU be displayed on the screen: 

SOFTWARE FORM [D&Lsseirase one chan of input data] [RET=end of input data] 

Architecture Information : 

Type : xtsun2] tsun3] tsun4] [Sun386i] 

Path where executables reside : /usr 

Tape Information ; 

Device Type : tarO] [ar8] xtstO] tst8] fmtO] [xtO] 

Drive Type ; xtlocal] [remote] 


Choice ; tall] {default] [own choice] xtreguired] tguit] 


CATEGORY NAME BYTES AVAIL BYTES Y/N 

required root XXXX XXXX y 

required Sys XXXX XXXX y 

required user XXXX XXXX y 

desirable Networking XXXX XXXX y 

Are you finished with this form ly/n] ? 

tx/x=select choice] [space-next choice] t'‘B/“P“backward] I''F/“N=forward] 


The Networking software will also be extracted since the system is on a network. 
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The list of categories to be extracted for the suii2 architecture will now be displayed on the Software Form below: 
SOFTWARE FORM fDEIa»erase one char of input data] [RETsMsnd of input data] 


Architecture information ; . 

Type j aclsun2] Esun3] tsun43 fSun386i] 

Path where executables reside : /usr 

Tape Information : 

Device Type : {ar03 [ar8] xlstO] [st83 fmtO] [xtO] 

Drive Type t xflocal] tremote] 


Choice : fall] fdefault] town choice] xfrequired] fquit] 


Extract list; 

Networking 

Are you finished with this form ty/n] ?y 

Cx/X«select choice] Ispace»next choice] f^B/'P^backward] I'F/''N*»forward] 


The Main Menu will be displayed on the screen when you are finished with this form. 
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CLIENT FORM 


one char o£ input data] [HBTsend o£ input data] 


Architecture Type j a:Isun2] [sun3] tsun4] tSun386i3 
Choice 5 X[Create] [delete] [diepiay] [next arch] 


Client(a) ; 
frodo Sofia 


Client Information : 

Name 

Internet Address 
Ethernet Address 

YP Type i [none] [master] [slav 

Domain name 

Path, of Client''s Root 

Path of Client's Swap 

Path of Client's Executables 

Path of Client's Home 

Swap size (e,g. SM^Sm,8K,8k,8 or 8b] 


; Sofia 
: 192.9.1.2 
: &;0:20:1:OOjOO 
[slave] X[client] 

; wseng.stm.com 
i /eaqport/root 
; /es^rt/swap 
: /expost/exec/sun2/ 
; /home 
r 8b] : 16M 


Are yOu finished with this form fy/n] ? y 

[x/X«select choice] [space«»next choice] [“B/'P^backward] {"F/''N*forward] 
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10. Start the installation by selecting [start the installation] and you will be prompted when the tape 
needs to be changed. If any information is missing, the installation will not start. You can go back and reassign 
all information and start it again. You should be expecting the following messages after the installation begins. 

. . .___ ^ 

System installation begin i 

Label disk(si t 
File systems check j 

/dev/rs^Oa: 140€24 sectors in 752 cylinders of 11 tracks, 17 sectors 

72,0Mb in 47 cyl groups (16 c/g, l,53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 

32, 3056, €080, 9104, 12128, 15152, 18176, 21200, 24224, 27248, 

30272, 33296, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 81168, 84192, 87216, 


htsqftext 


** /dev/xyOa 

** Currently Mounted on /a/ 

** tbase 1 - Check Blocks and Sizes 
** Phase 2 - check Pathnames 
** Bhase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl Croups 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 

System installation Coa^leted. 

Reboot your system and configure a kernel for your system. 
_ ^> 
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12. Login as root and run ypinit to set Up the yp databases. Details of how to setup and maintain yp databases are in 
the System Administration and Networking manual. 

13. Configure a kernel for your system. Refer to Appendix A for that information. If you wish to set a root password, 
see Chapter 3, Installing a root password. 
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4.4. Heterogeneous Server With a Local Tape Drive 

Assume the system has the following configuration; 

hostname: evans 
architecture: sun3 
system type:heterogeneous server 
supports architecture types: sun2 and sun4 
sun2 client: d2 

d2’s internet address: 192.9.1.1 
d2’s ethemet address: 8:0:20:1:00:00 
sun3 client: frodo 
frodo’s internet address: 192.9.1.2 
frodo’s ethemet address: 8:0:20:1:00:01 
sun4 client: d3 

d3’s internet address: 192.9.1.3 

d3’s ethemet address: 8:0:20:1:00:02 

internet address; 192.9.1.189 

local tape drive abbreviation; xtO 

2 Xylogics eagle disk abbreviation: xyO and xyl 

yp slave with domain "wseng.sun.com" 

sun2 software categories; aU 

sun3 software categories: all 

sun4 software categories: all 

1. Become super user and do a full dump of your system. 

2. Halt the system by doing the following: 


/ - 

evans #/Btc/halt 

: V 

V 



3. If you are installing this release on a new disk that does not have a label yet; or if you wish to change the size of 
the root partition, load MUNIXandrun format to label your disk. If you do not wish to change the existing 
disk label, skip this step and go to next step. 
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>b xt() 

Boot:act (0^ 0^4) ^asw 


root fileaystem type (apec 4.2 rif$):4.2 
root device (rd%dta-h3) :rd0a 
init ram diak from; stOa 
tape file nrurnber75 

$wap filoaysyatem type ($pec 4.2 fifs) ;apec 
swap device (na%dta-h]) :ns0a 


# forxnat 


Abort when you are done. 


4. Load the miniroot: 


>b xt() 

Boot: 3ct(0^0/2) 
From: xt(0,0^3) 
To; xy{0,0,l) 


Boot:xy{0^0^1)vmunix -asw 


root filesystem type ( spec 4.2 nfs):4.2 
root device (xy%d[a-*h3) :xy0b 


swap filesystem type (spec 4.2 nfs): spec 
swap device (xy%d[a“h3):xy0b 
Swapping on root device?y 
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Start suninstall: 


# ed /usr/etc/install 

# suninstall 

Entei: the . local time zone name: 

>> US/Pacific 

Is this the correct date/time ty/n]: 

Hon Mar 14 08:08:57 PST 1988 

Enter the current date and local time (e.g. 09/03/88 12:20:30); the date 

may be in one of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd-mm-yyyy 
dd-^mm-yy 
month dd, yyyy 
dd month yyyy 

and the time may be in one of the following formats: 
hh am/pm 
hh:mm am/pm 
hh.mm 

hh:mm am/pm 
hh,mm 

hh:mm:ss am/pm 
hh:mm:ss 
hh^ram^ss am/pm 
hh.mm.ss 

» 09/03/88 12:20:30 

Is this the correct date/time [y/n]: 

Wed Mar 9 12:20:30 PST 1988 


Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

» 3 


The following menu will now appear. 
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/. . ..— . ... - .. .^ 

Sun Microsystems System Installation: Tool 

Main Menu 

( Please use x or X to select your choice ) 

( 4 meatia th0 data file(s) exi$t(s) ) 

{ assign host information J 

[ assign disk information 1 

I assign software information ] 

I assign client information ] 

[ on-lino help information J 

[ start tho installation ] 

{ exit from suninstall ] 

[x/X=select choice] [space^^next choice] [''B/'P^backward] [''F/"N=^forward] 
---> 

The Main Menu will be displayed on the screen when you are finished with this form. 
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6. Assign host information by selecting [assign host information] in the Main Menu and the Host Form 
will be displayed on the screen: 

-- — ^ 

HOST FOHM ona Char of injmt data] [BET=and of input data] 

Workstation Infomation ; 

Name : evans 

Type : [standalone] xlserver] [dataless] 

Network Information t 

Ethernet Interface ; [none] *[ieO] 
internet Address 0 t 192.9.1.189 

YP Type : [none] [master] x[slave] [client) 

Pomainname wseng.sun.corn 

Misc Information ; 

(Iteration type : x[ install] [upgrade] 

Reboot after con^leted : [y] xin] 


Are you finished with this form fy/n] ? y 

[x/X“seleot choice] (space-next choice) [ “B/“P—backward) f "'F/'^N-forward] 
___> 


The numbers imder the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers wiU be 
different for each disk and they depend on the existing label on the disk specified. The main menu will be displayed 
on the screen when you are finished with the form. 
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7. Assign disk information by selecting [assign disk information] and the Disk Form wiU be displayed 
on the screen: 


DISK FORM 


[DBi^rase 

one char of input data] 

[SETsend of input data] 

Attached Disk Devices ? 





xt xyO] 

t xyi3 





Disk DabeX 


as [default 3 

[existing] 

[label in 

data file] 

Free Hog Disk Partition : 

ta] [d] 

[e3 t£3 x[g] 

th] 


Display Dnit 

: * [Mbytes] 

[Kbytes] [bytes] [blocks] [cylinders] 

PARTIIION 

STARI 

_CYh BDOCKS 

SIZE 

MOUNT PT 


PRESERVE (X/N) 

a 

0 

158^4 

iiiiiiiiiB 

J 



b 

XXX 

33440 

16 




c 

0 

140624 

68 




d 

XXX 

XXX 

0 

/export/root 


n 

e 

KXX 

XXX 

XXX 

/export/swap 



t 

0 

iiiiilliiiiiiiii 





9r 

XXX 

91256 

44 

/usr 


iiiiilliiiiiiiii 

h 

XXX 

XXX 

XXX 

/home 


iiiiiiiil iiliiiiiiii 

Ok to U3e 

this 

partition table [y/n] 

? y 



Are you finished with this 

form [y/nj 

? n 



lx/X«=select 

... 

choice] [space’S'next choice] ['"B/''P»backward] 

[-p/-N»forward3 

iiiiisiiiisjiiiiliiiiliiiil 


If you choose to use the entire disk, partition C, the other partitions wiU all be 0. The Main Menu will be displayed 
on the screen when you are finished with this form. 
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DISK FORM 


[DSiIr^rase oxte char of input data} [RBT=end of input data] 


Attached Disk Devices : 
i j^O] »{ xyl] 


Disk DabeX i 

Free H00 Di$k Partition t 
Display Unit : a 

PARTITION STARTjCYL BDOCKS 


b 0 0 

c 0 140624 

d 0 0 

e 0 0 

f 0 0 

g 0 0 

h 0 0 


xtdefault] [existing] [label in data file] 

W [dl [e] [f] at[g] [h] 

a[Mbytesl [Kbytes] [bytes] [blocks] [cylinders] 


KKJUNT PT 


PRESERVE (Y/N) 


/export/exec 


ok to use this partition table [y/n] 7 y 

Are you finished with this fontt fy/n] ? y 

[x/x«select choice] [space-next choice] [“E/''P*backward] [~F/^N«forward] 
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8. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form will be displayed on the screen. 

Select the software for the sun3 architecture: 

Software form IDBIi=erase one char of input dlata] IRKT=end of input data] 


Architecture Information : 

Type : fsunSj acfsunSj [sun4] [Sun386iJ 

Path where executables reside : /usr 

Tape Information : 

Device Type : (arO] - [af8] [stO] EstS] tmtO] X[xt0] 

Drive Type : ac [local] [remote) 

Choice : ac[ail] [default] [own choice] (required] [quit) 


CATEGORY NAME BYTES AVAIL BYTES Y/N 


required 

root 

xxxx 

xxxx 

y 

required 

Sys 

xxxx 

xxxx 

y 

required 

user 

xxxx 

xxxx 

y 

desirable 

Networking 

xxxx 

xxxx 

y 


Are you finished with this form [y/n] ? 

[x/X=select choice) [$pace=next choice] ("B/"P=backward] [ "F/''N=forward] 
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Select software for the sun2 architecture: 


SOFTWARE FORM [DEL^erase 

one char of input data) [RET=send of input 

.. . ^ 

data] 

Architecture Information : 





Type : xEsun2] 

[sun3] [sun4] 

ISun386i] 


Path where executables 

reside : /export/exec/sun2 


Tape Information : 





Device Type : [arO] 

[ar8] [stO] 

[st8] 

[mtO] xIxtO] 


Drive Type : acElocal] [remote] 




Choice : ac[all] 

[default] 

[own choice] [required] 

tquitl 

CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 

required 

Sys 

xxxx 

XXXX 

||i||||||||||i:||||i;^ 

required 

user 

xxxx 

xxxx 


desirable 

Networking 

xxxx 

XXXX 


Are you finished with this 

form [y/n] ? 




tx/X=select choice) fspace=next choice] ['"B/ 

''P=backwardl f F/"N=forward] 
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Select software for the sun4 architecture: 


Tape Infomation 
Device Type 
Drive Type 

Choice 


CATEGORY 


NAME 


BYTES 


AVAIL BYTES 


required 

required 

desirable 


Sys 

user 

Networking 


xxxx 

KXXX 

XXXX 


xxxx 

KXXX 

xxxx 


SOFTWABB FORM CDEL= 0 rase one char input data} [RET=end of input data] 

Architecture Information : 

IType ; tsun21 tsun3] at[sun4] fSun386i3 

Path where executables reside ; /e3qport/«*6c/8un4 


tarO] [arS] [stO] [st8] fmtO] x{xtO] 

X [local] [remote] 

: x[all] [default] [own choice] [required] [quit] 


Y/K 


Y 

y 

y 


Are you finished with this form, [y/n] ? 

[x/X»select choice] [space-next choice] [^B/^P^backward] [^F/'"N«forward] 
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The list of categories to be exacted for the sun4 architecture will now be displayed on the Software Form below: 


SOFTWARE FORM [DELa^rase one char of input data} (RET^nd of input data] 

Architecture Information : 

Type : {sun2] [sun3] xC5un4] [Sun386iJ 

Path where executables reside :/export/exec/sun4 

Tape Information : 

Device Type : {arO] [ar8] [etO] [st83 (mt03 xIxtO] 

Drive Type t xflocalj .[remote] 


Choice 


1 xtall] tdefault] [own choice] [required] [quit] 


Extract list: 

sys 

user 


Networking 


Are you finished with this form ty/n] ?y 

[x/X=select choicel tspace=next choice] ["B/"P=backward] f"F/""N=forward] 


The Main Menu will be displayed on the screen when you are finished with this form. 
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f .-.............................> 

CLIENT FORM [Dl!L=era8e one char of input data] [RETsend of input data] 

Architecture Type : [sun2] x[sun3] [sun4] tSun386il 

Choice ; at [create! 

^display] fnext arch] 

Client ($) : 


frodo 


Client Xiifomtation : 


Name 

: frodo 

Adctre$$ 

; 192.9.1.2 

Ethernet Address 

: 8:0:20:1:00:01 

YP Type ; fno^ej fma^tor] [alav^j 

Domain name 

: wseng. sxm . com 

Path ot ClientRoot 

; /export/root 

Path of Client's Swap 

: /export/swap 

Path of Client^s Executahies 

: /export/exec/sun3/ 

Path of Client's Home 

: /home 

Swap aize (e.g^ SM/Sm, or 8b> 

: 16M 

Are you finished with this form fy/n] 


[x/X“aeiect choicej {spaoe=next ohoicel 

V . 

[ '’B/ ^P“backward] l^'F/ Orward] 

j 


CLIENT FOm 


{DSXirs^case one chas of input data] £RET=end of input data] 


Architecture Type i [sun2] [sun33 *£sun4] tSun386i] 

Choice : x[create] [delete] [display] [next arch] 

Client(s) : 


Client Information : 

Name 

Internet Address 
Ethernet Address 

IF Type : [none] [master] [sla’v 

Domain name 

Path of Client*^8 Foot 

Path of Client's Swap 

Path of Client's Executables 

Path of Client's Home 

Swap sire (e.g. 8M,8m,8K, Sk,8 or 8b] 


: d3 

; 192.9.1.3 
: 8 : 0 : 20 : 1 : 00:02 
[slave] x[client] 

: wseng.sun.ctxn 
; /export/root 
: /export/swap 
: /e3^>ort/exec/sun4/4.0 
: /home 
r 8b] ; 16M 


Are you finished with this form [y/n] ?y 

[x/X“select choice] Cspace=*next choice] ["B/'P=backward] {"F/"N^forward] 
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The Main Menu will be displayed on the screen when you are finished with this form. 
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10. Start the installation by selecting [start the installation] in the Main Menu and you will now be 
prompted when the tape needs to be changed. If any information is missing, the installation will not start and the 
Main Menu will be displayed on the screen. You can abort the installation any time by using I CTRL-C ] and 
either restart it by using the existing information or reassign information before restarting the installation. You 
should be expecting the following messages after the installation begins. 


---—-V 

System Installation begin : 

Label diskts) ; 

xyO xyl 

File systems check ; 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks, 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 

32, 3056, 6080, 9104, 12128, 15152, 18176, 21200, 24224, 27248, 

30272, 33296, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 81168, 84192, 87216, 

90240, 93264, 95776, 98800, 101824, 104848, 107872, 110896, 113920, 116944, 

119968, 122992, 126016, 129040, 132064, 135088, 138112, 


lots of text 


** /dev/xyOa 

**■ Currently Mounted on /a/ 

** Phase 1 - Check Blocks and Sixes 
** Phase 2 •* Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl Croups 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 

System Installation Completed. 

Reboot your system and configure a kernel for your system. 

|i|||i||:||||||||||||||||||||||||;|||||||:;:i!i||;|| 

___ j 


11. Abort the system since the reboot option is not being selected in the Host Form. Use I Ll-A I for Sun monitors or 
1 BREAK I on Wyse terminals to abort the system. Boot the system by using the command 


.. 

^ ___ > 


12. Configure a kernel for your system. Refer to Chapter 7 for instructions on how to configure a kernel. 

13. Run ypinit to set up the yp database. See System Administration and Networking on the Sun Workstation 
for detailed instructions on how to set up and maintain yellow pages. If you wish to set a root password, see 
Chapter 3, Installing a root password. 
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4.5. Dataless Configuration With Local Tape Drive 

Assume the system has the following configuration; 

hostname; evans 

architecture; sxm4 

ethemet interace; ieO 

ip address; 192.9.90.64 

yp client of domain; "weng.sxm.com" 

ISCSI disk; sdO 

local SCSI tape drive; stO 

sim4 server; godzilla 

server ip address; 192.9.90.11 


1. Become super user and do a full dump of your system. 

2. Halt the system by doing the following; 

evans#/etc/halt 
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3. If you are installing this release on a new disk that does not have a label yet; or if you wish to change the size of 
the root partition, load MUNIX and run format to label your disk. If you do not wish to change the existing 
disk label, skip this step and go to the next step. 


>b St (0,0,0) 

Boot:st (0,0,4) “-asw 


root filesystem type (spec 4.2 nfs);4.2 
root device (rd%dla-h]):rd0a 
init ram disk, from; StOa 
tape file numb6r'?5 

swap filesysystem type (spec 4.2 nfs):spec 
swap device (ns%d[a-hl) :xis0a 


fformat 

Abort when you are done. 
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>b sb(0,0,0) 
Boot: St (0,0,2) 
From: st(0,0,3) 
To: *y(0,0,1) 


Boot:a^(0,0,l)'vxnunlz -asw 


root filesystem type ( spec 4.2 nfs):4.2 
root device (xy%d[a-li)) :xy0b 
Swapping on the root device? y 


swap filesystem type (spec 4.2 nfs): spec 
swap device (xy%d(a-'h3) tatyOb 
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5. SidJX suninstall: 

( ----— . —----> 

# ed /usr/et:c/inst:all 

# auAiii$t:aXX 

Enter: the local time ?5one name: 

» US/Paeific 

Is this the correct date/time ty/n]: 

. Hon Mar 14 08:08:57 PSt 1988 . 

i||||;|||i|i|||||||||;||i||||;||||||||||||||^ 

Enter the current date and local time (e.g. 09/03/88 12:20:30); the date 

may be in one of the following formate: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd-mm-yyyy 
dd^mm^yy 
month dd, yyyy 
dd month yyyy 

and the time may be in one of the following formats: 
hh am/pm 
hh:mm am/pm 
hh .mm 

hh :mm am/pm 
hhlmm 

hh:mm:ss am/pm 
hh:mm:a3 
hh^mm.ss am/pm 
hh.mm.ss 

» 09/03/88 12:20:30 

Xs this the correct date/tirae [y/nj: 

Wed Mar 9 12:20:30 PST 1988 


Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

» 3 


The following menu will now appear. 
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Sun Microsyst^s System InstalXatioix Tool 
Main Menu 

{ Fleaae use x or X to select your choice ) 

{ ^ m 0 ati$ the <iata fiie(s) exist (a) ) 

[ aaai^h hast information J 

[ assign disk infomation J 

[ assign software information J 

{ asaign client information ] 

I an--line help^ information } 

[ start the installation } 

{ exit from suninstall J 

[x/X“Select choice] [space^next choice] ['"B/''P=baCkward] "N=fOrward] 
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6. Assign host information by selecting [assign host information] in the main menu and the Host Form 
will be displayed on the screen: 

- — 

HOSf J’ORM [DElrs^rase Otte Char of input <3ata3 lRET=en<l of input data] 

Workstation Information : 

Name : evana 

T'ype : Estandalone] [server] * [dateless J 
Server: godrilla 

Server Internet Address; 192♦9.90,11 
Path of the executable on server: 

Network Information : 

Ethernet Interface : [none] x[ie03 
Internet Address 0 ; 192.9.90.64 

yp Type : [none] (master] [slave] * [client] 

bomainname ; wsong,sun. C<Ml 

Misc Information ; 

Operation type : xtinstall] [upgrade] 

Reboot after completed : [y] *[n3 i 


Are you finished with this form Cy/n] ? y 

(x/x=select choice] (space=next choice] t'^B/“P=backward] [“F/"N=forwardl 

_ ' _ j 
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7. Assign disk infonnation by selecting [assign disk information] in the Main Menu and the Disk Fonn 
will be displayed on the screen: 


DiSK FORM 

[DEL=exras« one char of input data] 

[RETsend of input data] 

Attached l>isk Devices : 





xt sdOl 






Disk Label 


xldefault] 

[existing] 

[label in data 

file] 

Free Hog Disk Partition : 

tal fd] 

[e] tf] x[g] 

th] 


Display Unit 

: X[Mbytes3 

[Kbytes] [bytes] [blocks] 

[cylinders] 

PARTITION START_CYL BLOCKS 

SI2E 

MOUNT BT 

PRESERVE (Y/N) 

a 0 

15884 


/ 



b 0 

33440 

16 




c 0 

140624 

68 




d 0 

0 

0 




e 0 

0 

0 




f 0 

0 

0 




g 0 

91256 

44 




h 0 

0 

0 




Ok to use this 

partition table [y/n] 

? y 



Are you finished with this 

fom ty/n] 

? y 



[x/X-seiect 

choice] [space-next choice] 

backward] 

N-forward] 


The numbers under the coliunns START_CYL, BLOCKS, and SIZE are for this example only. The numbers will be 
different for each disk and they depend on the existing label on the disk specified. The main menu will be displayed 
on the screen when you are finished with the form. 
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8. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form will be displayed on the screen: 


c - 





> 

SOFTWARE FORM 

one char of injmt data] [KBT^nd of input data] 


Architecture information : 






Type : tsun21 

xtsunSl 

[sun4] 

tSun386i] 



Path where executabiea 

reside :/ 





Tape information : 






Device Type : larO] 

tarS] xtstOj fstS] 

tmtO] [xtO] 



Drive Type : jctlocai] 

[remote] 





Choice j tall] 

tdefault] 

[own choice] xtrequired] 

tquit] 


CATEGORY 

NAME 

BYTES 

AVAII. BYTES 

Y/N 


required 

root 

xxxx 

XXXX 



required 

Sys 

xxxx 

xxxx 



required 

user 

XXXX 

XXXX 

iiiiiiiiiiiiiiiii 


Are you finished with this 

form ty/n] 

iiiiliiiii 




tx:/x«3elect choice) [space^next choice) ['^B/ 

^ . 

“P—backward] t''F/*N“£orward] 

_/ 


Dataless configuration does not need to select software categories since it is mounting /usr from a server but some 
of the required categories will be loaded for installation purposes. 
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The list of categories to be extracted will be displayed on the Software Form below: 


SOFTWARE FORM one char of input data] tRET==end of input data] 

Architecture Information : 

Type : tsun2] xtsun3] C5un4] CSun3B6i] 

Path where executables reside :/ 


{arO] [arS] x[stO] [stSJ [mtO] [xtO] 
X[local] [remote] 


Device Type : tarO] [arS] x 
Drive Type : x[local] [remo 
Tapehost : 

Tapehost^s Internet Address : 


Choice 


[all] [default] town choice] xtrequired] fquit] 


Extract list: 


Are you finished with this form [y/n] ?y 

[x/X=select choice] [space=next chdicel I""B/"P=backward] ['"F/"N=forwardl 


Only part of the user category will be extracted for the dataless configuration. The Main Menu will be displayed 
on the screen when you are finished with this form. 
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9. Start the installation by selecting [start the installation] in the Main Menu and you will be 

prompted when the tape needs to be changed. If any information is missing, the installation wiU not start and the 
Main Menu wiU be displayed on the screen. You can abort the instaUation anytime by using ICTRL-CI and either 
restart it by using existing information or reassign information before restarting the instaUation. You should see 
the foUowing messages after the instaUation begins. 


--—___—_____________________________—--- 

System Installation begin : 

Label diskts) ; 

||||||||||||||||||i||||||||||||i|||||||ii;|||;ili||||||||^ 

File systems check ; 

/dev/rsdOa: 140S24 sectors in 752 cylinders of 11 tracks, 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 

32, 3056, 6080, 9104, 12128, 15152, 18176, 21200, 24224, 27248, 

30272, 33256, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 8X168, 84192, 87216, 

90240, 93264, 95776, 98800, 101824, 104848, 107872, 110896, 113920, 116944, 

119968, 122992, 126016, 129040, 132064, 135088, 138112, 

svin3 Installation Begin : 

Extracting '"root" files from "/dev/nrstO" release tape. 

Extracting "Sys** files from "/dev/nrstO" release tape. 

Extracting sun3 executables from "/dev/nrstO" release tape. 

Checking filesystems : 

** /dev/sdOa 

** Currently Mounted on /a/ 

** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 — Check Reference Counts 
** Phase 5 - Check Cyl Groups 

/dev/rsdOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 

System Installation Completed. 

Reboot your system and configure a kernel for your system. 
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10. Abort the system since the reboot option is not being selected in the Host Form. Use (Ll-AI for Sim monitors or 
<bi:eak> on Wyse tenninals to abort the system. Boot the system by using the command 

>h 

11. Configure a kernel for your system. Refer to Appendix A for instmctions on how to configure a kernel. 
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Remote Installations 


5.1. Introduction 

The chapter provides instructions for remote installations for the following: 

□ Standalone Configuration with a Remote Tape Drive 

□ Homogeneous Configuration with a Remote Tape Drive 

□ Heterogeneous Configuration with a Remote Tape Drive 

□ Dataless Configuration with a Remote Tape Drive Section 

In order to perform a remote installation, you must have SunOS Release 4.0 running on your tapehost. You will 
configure your target machine as a diskless client of the tapehosL Your tapehost will act as the server for your tar¬ 
get machine. 

5.2. Installation 

Regardless of the configuration you are installing do the following steps first. 


On the tapehost do the following: 


1. Load the miniroot. Substitute your tape device and number (mt, st, xt, ar) for u^edeviceit (eg: mtO, mtS, etc) and 
architecture type (sun2, sun3, or sun4) of the target machine for ARCH in the following procedure. 



NOTE The above is the recommended place to put the miniroot. However, you can use a different directory. If you 
do make sure that it is accessible to your target machine and there is enough space. You need a minimum ofbMbytes 
of disk. 


2. If the tapehost is running yellow pages, the master /etc/hosts and master /etc/ethers should contain 
the target machine’s addresses. If the tapehost is not running yellow pages, local /etc/hosts and 
/etc/ethers should contain the target machine’s addresses. 

3. Run setup_client to create the target machine as a diskless client of the tapehost. See 
setup_client (8) for complete information on how to do this. Make sure the information added to 
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et c /bootpar ams on the target machine is put on the yp master and then pushed to all users. 


Now on the target machine, do the following: 

1. Boot from the tapehost Substitute the proper Ethernet abbreviation (ec, ie, le) for ethernet. 


>h 0 thernetO 

root filesystem type {spec 4.2 nfs) :nfs 
root name;<CR> 

Boot: vxrmnxx 


root filesystem type (spec 4^2 nfs) ;nfa 
root name:<CR> 


swap filesystem type (spec 4^2 nfs) ; nfs 
swap name:<CR> 
lO^in: root 

_ > 


2. Create the disk devices after the system is up. Substitute your disk device (xy, sd, xd) and number for diskdev- 
ice# (eg:xy0). 



3. If you want to change partition sizes, you can now run format. Otherwise, go to the next step. 

4. Load the miniroot onto the disk. 

targetmachine# dd if=/usr/JlocaX/miniroot of=/diev/r£/ufcfeWce#b 
. . ...> 

NOTE: /usr/local/miniroot is the same as /export/exec/ARC///local/miniroot because the 
target machine mounts /export/exec/A^C// on /usr. 

5. Boot the miniroot. 
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. .. . . —^™^— .. —"—"—\ 

targetmachine# /efcc/halt 
> b Ethernet 1) -as* 

root filesystem type <spec 4.2 nfs): 4.2 
root <ievice idiskdetdceffb 
Boot: vxmmix 


root filesystem type (spec 4.2 nfs};4.2 
root device iMskdevice^ 


swap filesystem type (spec 4,2 nfs); spec 
swap device Cxy5d[a-h] :diskdet4ce^ 

Swapping on root device? y 


V___> 

6. When you have completed the installation, you can remove the client partition created for the target machine 
with setup_client using the remove optioa 

Now proceed to the section that pertains to the configuration you wish to install. 

□ Standalone (Section 5.2) 

□ Homogeneous (Section 5.3) 

o Heterogeneous (Section 5.4) 

□ Dataless (Section 5.5) 

5.3. Standalone Configuration With a Remote Tape Drive 

Assume you have a system with the following configuration: 

hosmame: evans 

architecture: sun2 

system type: standalone 

internet address: 192.9.90.64 

remote SCSI tape drive: stO 

ethemet interface: ieO 

sun2 tape host: godzilla 

tape host’s internet address: 192.9.90.51 

1 Xylogics eagle disk: xyO 

yp client of domain "wseng.sun.com" 

software categories: all 

1. Start suninstall: 
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# cd /usr/etc/instaXl 

# auniziat^all 

the local tiino z.pn^ naiti^: 

» US/Pacific 

Xs this the correct date/time fy/n]: 

Mon Mar 14 08:08:57 PST 198$ 

Enter the current date and local time (e.g- 09/03/88 12:20:30); the date 
may be in oue of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm*yyyy 
dd^mm-'yyyy 
dd-mm-yy 
month dd^ yyyy 
dd month yyyy 

and the time may be in one of the following formats: 
hh am/pm 
hh: mm am/ pm 

hh;mm am/pm 

hh:mm:$s am/pm 
hh:mm:ss 
hh^mra.ss am/pm 
hh.mm.ss 

» 09/03/88 12:20:30 

Is this the correct date/time [y/nj: 

Wed Mar 9 12:20:30 PST 1988 


Select your terminal type: 

1) Televideo 925 

2) Wyse Model 50 

3) Sun Workstation 

4) Other 

» 3 


The following menu wiU now appear. 
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Sun Microsystems System Installation Tool 
Main Menu 

( Please use x or X to select your choice ) 

< -f moan$ the ciata fiie($) exist (a) ) 

[ assign host information ] 

[ assign disk information J 

( assign software information ) 

[ assign client information ] 

[ on-line help information J 

[ start the installation ] 

[ exit from suninstall J 

tx/X-select choicel [space-next choicel l^B/*'P-backwardl l^F/"N-forwardl 
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2. Assign host infomiation by selecting [assign host information] in the Main Menu and the Host Fonn 
will be displayed on the screen: 

r ^ 

HOST tom char of input data! lRET=end of input data! 

ISorkstation Information ; 

Name : evens 

"lype ; xfstantialone] [serverl C<iataiess3 


Network information t 

Ethernet Interface ; [none] *[ie0] 

Internet Address 0 : 192.9.90.64 

XE Type : [none] [master] [slave] x[client] 

Eomainname : wseng.snA.com 

Misc Information ; 

Operation type t x[ install] [upgrade] 

Reboot after coa^leted : *[y] [n] 


Are you finished with this form Cy/n] ? y 

[x/X-select choice] [space-'next choice] ['‘B/'P>=backward] r''F/*N=forward] 

^^ 


The main menu will be displayed on the screen when you are finished with the form. 
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3. Assign disk inforaiation by selecting [assign disk information] in the Main Menu and the Disk Fonn 
will be displayed on the screen: 


DISK FORM Char Of data! [lOSlFsaad Of input data] 

Attached Disk Devices i 

||i|||||W|||||||||||||||||||i|||||||||™^^^^ 


Disk Dabel : [default] [existing] [label in data file] 

Free Hog Disk Fartition : [a] fd] [e] [£] x[g] [h] 

Display Unit : x[Mbytes] [Kbytes] [bytes] [blocks] [cylinders] 


FAR1ITI0N SfARf CYD BDOCKS 


a 

b 

c 

d 

e 

£ 

9 

h 


0 

XXX 

0 

0 

0 

0 

XXX 

0 


15884 

33440 

140624 

0 

0 

0 

91256 

0 


SI2B 

7 

16 

68 

0 

0 

0 

44 

0 


MODtIT FT 

/ 




PRESERVE<y/N) 
n 


/usr 


n 


Ok to use this partition table [y/n] .7 y 

Are you finished with this form [y/n] 7 y 

[x/X»select choice] [space«next choice] ["B/"R»backward] ["F/'N^forward] 


The numbers imder the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers will be 
different for each disk and they depend on the existing label on the disk specified. The main menu will be displayed 
on the screen when you are finished with the form. 
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4. Assign software infonnation by selecting [assign software information] in the Main Menu and the 
Software Form will be displayed on the screen: 


SOFTi^ARB FORM [DBl^rase onm Chat OH input data] tlU8?l^=end of input data] 
Architecture Information : 

:Eype *tsutt21 [sun3] fsun4] tSun386il 

Path where executahles reside i /usr 

fape Information ; 

Device Type : tarO] tarS] x£stO] [stS] [mtO] fxtO] 

Drive Type ; flocal] xlr^note] 

Tapehost : godzilla 
Tapehost * a Internet Address ;192,9.90♦51 

Choices xfall] [default] [own choice] [required] [quit] 


CATEGORY 


BYTES 


AVAIL BYTES 


required root XXXX XXXX 
required Sys XXXX XXXX 
required user XXXX xxxx 
desirable Networking XXXX XXXX 


Are you finished with this form [y/n] ? 

[x/X“sel6ct choice] [space^next choice] [''B/'"P=backward] t~F/'‘H=fotward] 
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The list of categories to be extracted for the sun2 architecture are now displayed on the Software Form below: 


- ' 

SOFTWARE FORM (DELn^erase one char of Inptit data} [EiETwend of iiqmt data} 


Arehltaoture Information : 

"JPype ; *[s«n2} Esa»33 ls«n4] {S«n386i} 


Path where erecutables reside t/usr 
Tape Information : 

Device Type ; larO} [ar8] »[st03 [at83 Emt03 fxtO] 

Drive Type t flocaij *tremote3 
Tapehost tgodriiXa 

Tapehost^s Internet Address :192.9.90.51 
Choice: xEall} Idefaultj town choice] txequiredl [quit] 


Extract list: 

root 

sya 

user 

Networking 

Debugging 


Are you finished with this form fy/n] ? y 

Ix/X»select choice] [space»viext choice] ['‘B/'‘P«'back.ward] l’'F/^N«'forwardl 

‘s.— . .....> 


The main menu wiU be displayed on the screen when you are finished with the form. 
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5. Start the installation by selecting [start the installation] and you will be prompted when the tape 
needs to be changed. If any information is missing, the installation will not start. You can go back and reassign 
aU information and start it again. You should be expecting the following messages after the installation begins. 

. . . . . . .. 

System Installation begin : 

Label disk{s} : 

File Systems check ; 

/dev/rxyOa: 140624 sectors in 752 cylinders of 11 tracks, 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 

32, 3056, 6000, 9104, 12128, 15152, 18176, 21200, 24224, 27248, 

30272, 33296, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 81168, 84192, 87216, 

90240, 93264, 95776, 98800, 101824, 104848, 107872, 110896, 113920, 116944, 
119968, 122992, 126016, 129040, 132064, 135088, 138112, 

tots of text 


Checking filesystems : 

/dev/xyOg 

** Currently Mounted Oil /a/uSr 

Phase 1 “ Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 “ Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl Groups 

/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
Rebooting the System 


evans login: 

V-:___ > 

6. Configure a kernel for your system. See Appendix A for instructions. 
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5.4. Homogeneous Server With Remote Tape Drive 

Assume the system has the following configuration: 

hostname: evans 

architecture: sun3 

system type: homogeneous server 

sun3 client(s): sofia and firodo 

fiodo’s internet address: 192.9.90.1 

frodo’s ethemet address: 8:020:1:00:00 

Sofia’s internet address: 192.9.90.2 

Sofia’s ethemet address: 8:0:20:1:00:01 

internet address: 192.9.90.64 

remote SCSI tape drive: stO 

sim3 tape host: godzilla 

tape host ip address: 192.9.90.51 

1 Xylogics eagle disk: xyO 

yp slave of domain "wseng.sun.com" 

software categories: required 

1. Start suninstall: 
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# cd /usr/etc/install 

# sunixist^all 

Ent^r tho local ti-mo zone name: 

» US/]Pacific 

Xs this the correct date/txme ty/n]: 

Mon Mar 14 08:08:57 FST 198$ 

Enter the current date and local time (e.g. 09/03/88 12:20:30); the date 

may he in one of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm*yyyy 
dd-^inm-yyyy 
dd-mm-yy 
month dd^ yyyy 
dd month yyyy 

and the time may be in one of the following format$: 
hh am/pm 
hh:inm am/pm 
hh.mm 

hh:mm am/pm 

||||||||||||||iiii||||®a|||||||||||||||||||||||||||||;i|;| 

hh:mm:s$ am/pm 
hh:mm:ss 
hh^mm.ss am/pm 
hh*mm. ss 

» 09/03/88 12:20:30 

Xs this the correct date/time [y/n]: 

Wed Mar 9 12:20:30 PST 1988 

||||||;|||||||||||||^^^^^^^^ 

Select your terminal type: 

1) Televideo 925 

2) Wyae Model 50 

3) Sun Workstation 

4) Other 


The following menu will now appear. 
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Sun Mxcrosystems System Installatxon Tool 
Main Menu 

( Please use x or X to select your choice ) 
( -f the <iata fiie($) exi$t{3) ) 

[ asai^ host information J 

[ assign disk information 1 

[ aasign software information J 

[ assign client information 1 

I on-line helf> information J 

[ Stuart the installation 1 

[ exit from suninstall J 


[x/X“seiect choice! [space^next choicel ["^B/^p^hackwardi i''F/''N=forwardj 
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2. Assign host infonnation by selecting [assign host information] in the Main Menu and the Host Fonn 
wiU be displayed on the screen: 

-— - — 

HOST FORM [DBIrseuaae oiwt char of input data] [RET=and Of input data] 

Workstation Information : 

Name : evans 

type : [standalone] x[servejr] [dataleas] 


Network Information t 

Ethernet Interface : [none] x[ieO] 

Internet Address 0 t 192 .9.90.64 

YF Type 
Doma inname 

Misc Information : 

Operation type : xfinstall] [upgrade] 

Reboot after completed : xly] [n] 


Are you finished with this form [y/n] ? y 

[x/X=select choicel [space=next choice] [ "B/"P=backwardl [ "F/"‘N=forward] 


The Main Menu will be displayed on the screen when you are finished with this forni. 
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3. Assign disk information by selecting [assign disk information] in the Main Menu and the Disk Form 
will be displayed on the screen: 

--- 

DISK [DSL=drasft on6 Char o£ ln{nit data] [R£T=end of input data] 

Attached Pisk Devices t 
act xyO] 


Disk Dabei : [default] [existing] [label in data file] 

Free Hog Disk Partition : [a] fd] [ej [f] x[g] [h] 

Display Unit : x[Mbyte3l [Kbytes] [bytes] [blocks] [cylinders] 


PARTITIOH 

START^CXh BDOCKS 

SX2B 

MODNt P3* 

PRESERVE(X/E) 

a 

0 

15884 

rnKMmMm 

/ 


b 

XXX 

33440 

16 



c 

0 

140824 

68 



d 

XXX 

XXX 

XXX 

/export/roQt 

iiiiiiiiiiiiiiiiiiiiiiiiiii 

e 

0 


liiiiiiiiiiiiliii 

/export/awap 


f 

0 





cr 

XXX 

91256 

44 

/usr 


h 

XXX 

XXX 

XXX 

/home 


Ok to use 

this 

partition table ly/n] 



Are you finished with this 

form ty/n] 

? y 


[x/Xs®select 

choice] Ispace»next choice] ['‘B/^P^backward] 

{‘^F/'U^forward] 


The numbers under the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers will be 
different for each disk and they depend on the existing label on the disk specified. The main menu wiU be displayed 
on the screen when you are finished with the form. 
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4. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form will be displayed on the screen: 


SOFTWARE FORM [DEIiserase On© char of input data] [RET=end of input data] 


Architecture Information ; 

Type : tsun£] at[sun31 [sun43 

Path where executables reside ;/usr 


tSun386il 


Tape Information ; 

Device Type : larO] [arS] [stOj acfstS] fmtO] [xtO] 
Drive Type : {local] [remote] 

Tapehost : godzilla 

Tapehost's Internet Address :192.9.90.51 


Choice 


t {all] {default] {own choice] x[required] [quit] 


CATEGORY 

required 

required 

required 

desirable 


BYTES 


Sys XXXX 
user XXXX 
Networkinq XXXX 


AVAIL BYTES 

XXXX 

XXXX 

XXXX 

XXXX 


ArB you finished with this form Cy/n] ? 

tx/x=select choice] [space=next choice] t"B/"P»backward] t"F/"N=forward] 


Networking software will be loaded since the system is on a network. 
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The list of categories to be extracted for the sun3 architecture will now be displayed on the Software Fomi below: 


f ---- ' 

SOFTWARE FORM CD£L»exrase one char o£ input data} [R£T:ttaind o£ input data] 


Architecture Type Information : 

Type : tsun23 3c[sun3] [sun4] CSun386iJ 

Fath where executables reaide :/usr 

Tape Infontiation ; 

Device Type : larO] tar8] tstO] xtst8] tmtOJ {xtO] 

Drive Type : [local J xfretriotej 

Tapehost : godziXia 

Tapehoet'e internet Addresa ;i92,d,dO^Si 

Choice : lallj (default] (own choice] xlrecpiiredl (<3uit] 


Extract list: 

root 

ey$ 

user 

Ketworking 


Are you finished with this form ty/n] ? 

tx/Xssselect choice} (apace^^ext choice} t'^B/'^Pssbackward} (""F/^Nwforward} 
_> 


The Main Menu will be displayed on the screen when you are finished with this fonn. 
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5. AssigncUent infoimation by selecting [assign client information] in the Main Menu 
and the Client Form will be displayed on the screen. 


CLIENT FORM 


iDELsserase ona char of input data] iRETssend of input data] 


[$un2] xlsun3] [3un41 ($un366i3 

X[create! [delete! [display! [next arch] 


Arohitectura Typo 
Choice 

Client(s) : 
frbdo 


Client Information : 

Name : 
Internet Address : 
Ethernet Address : 
YP Type : [nonel [master] [slave] 
Domain name : 
Path of Client^ s Root : 
Path of Client's Swap : 
Path of Client'^s Executables : 
Path of Client's Home : 


frodo 

192*d.90.1 
8 : 0 : 20 : 1 : 00:00 
X [client] 
wseng * sun.com 
/export/root 
/export/swap 
/export/exec/sun3/ 
/home 


Swap size (e.g* 8M^$m^8K^8k^8 or 8b) : 16M 


Are you finished with this form ty/n] ? n 

[x/X“select choice] [space^next choiceJ [‘'B/"’P==backward3 f"F/'‘N=forward] 


The Main Menu will be displayed on the screen when you are finished with the fomi. 
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CLIENT FOKH 


{i;)EXr=era8e one char of inpat data] [EBT=end of input data] 


Architecture Type 
Choice 


[cun21 xlsunS] Esun4] tSunSB611 
xtCreate] [delete] [diepiayj [next arch] 


Client(s) : 
frodo Sofia 


Client Information : 

Name 

Internet Address 
Ethernet Address 

yp Type : [none] [master] [slav 

Domain name 

Path of Client^s Root 

Path of Client's Swap 

Path of Client^a Executables 

Path of Client''$ Home 

Swap size (e.g* 8m, 8K, 8kjr S or 8b) 


; Sofia 
: 192.9.90,2 
: 8t0:20:l:00:01 
[slave] X[client] 

; wseng^sun.com 
: /export/root 
: /export/swap 
r /export/exec/sun3/ 
; /hotde 
r 8b) : 16M 


Are you finished with this form fy/n] ? y 

[x/X-select choice] [space-next choice] ["B/^'P-backward] {"F/^N-fcrward] 
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6. Start the installation by selecting [start the installation] and you will be prompted when the tape 
needs to be changed. If any information is missing, the installation will not start. You can go back and reassign 
all information and start it again. You should be expecting the following messages after the installation begins. 


System Installation begin : 

Label disk(s) : 

File systems check : 

/dev/rjq^Oa: 140€24 sectors in 752 cylinders of 11 tracks, 17 sectors 

72.0Mb in 47 cyl groups (16 c/g, 1.53Mb/g, 640 i/g) 
super-'block backups (for fsck -b#) at: 


32, 3056, 6080, 9104, 

12X28, 

15152, 

18176, 

21200, 

24224 

, 27248, 


30272, 

33296, 36320, 

39344, 

42368, 

45392, 

47904, 

50928, 

53952, 

56976 

60000, 

63024, 66048, 

69072, 

72096, 

75120, 

78144, 

81168, 

84192, 

87216 


tots of text 


** /dev/xyOa 

** Currently Mounted on /a/ 

** Fhase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl Croups 

/dev/rj:yOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
Rebooting the system 


evans login; 

_ ______ > 
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7. Configure a kernel for your system. Refer to Appendix A for instructions on how to configure a kernel. 

8. Run ypinit to setup the yp database. See System and Network Administration maiaial for dttdiled instruc¬ 
tions on how to set up and maintain yellow pages. 
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5.5. Heterogeneous Server With a Remote Tape Drive 

Assume the system has the following configuration: 

hostname: evans 

architecture: sim3 

ethemet interface: ieO 

system type:heterogeneous server 

supports architecture types: sun2 and sun4 

sun2 client: d2 

sun3 client: frodo 

sun4 client: d3 

d2’s internet address: 192.9.1.1 
d2’s ethemet address: 8:0:20:1:00:00 
frodo’s internet address: 192.9.1.2 
frodo’s ethemet address: 8:0:20:1:00:01 
d3’s internet address: 192.9.1.3 
d3’s ethemet address: 8:0:20:1:00:02 
internet address: 192.9.90.64 
remote tape drive abbreviation: xtO 
tape host: godzilla 

tape host’s internet address: 192.9.90.51 
2 Xylogics eagle disk abbreviation: xyO and xyl 
yp slave with domain "wseng.sun.com" 
sun2 software categories: aU 
s\m3 software categories: all 
sun4 software categories: all 


1. Start suninstall: 
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/— - — -.... ..^— --------- . 

Stin Microsystems System Installation Tool 

Main Menu 

( Please use x or X to select your choice } 

< moati$: the <iata file(S) exist {s) ) 

{ assign host information J 

[ assign disk information 1 

[ assign software information ] 

[ assign client information ] 

I on--line help information J 

[ start the installation 1 

[ exit from suninstall J 

[x/X=seleCt choice} [spaoe^next choice} ["B/"P«baCkward] ["F/"N=fOrward] 

V. ...> 
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2. Assign host information by selecting [assign host information] in the Main Menu and the Host Form 
win be displayed on the screen: 

HOST FORM [DSIi^rAAe one chan of input data} [BET=end of input data] 

Workstatiorr Information : 

Name : evana 

Type : [standalone] *[server] [dataless] 

Network Information i 

Ethernet Interface : [none] *[ieO] 

Internet Address 0 : 192.9.90.64 

YR Type : [none] [master] *[slave] [client] 

Pomainname : wseng.sun.com 

Misc Information ; 

Operation type : x[install] [upgrade] 

Reboot after completed : [y] *[n] 


Are you finished with this form [y/n] ? y 

[x/X*=sel6ct choice] [space=next choice] ['■B/”P=backward] ['‘F/''N=forward] 

L______ i 
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3. Assign disk information by selecting [assign disk information] in the Main Menu and the Disk Form 
will be displayed on the screen: 


DISK FORM 


[D&l)=«]:ase one char c£ input date] [KBX=an<l o£ input data] 


Attached bisk bevices : 

xt xyOl t xyl] 


bisk babei 


xCdefault] 

[existing] [label in data file] 

Free Hog bisk Partition : 

laj Idl 

[e] [f] x[gl [h] 


bisplay Unit 

liiliiiisiiliiilii 

aCMbytes] 

[Kbytes] [bytesj 

[ hi ocka ] [ oyl inde ra ] 

PARTITION START 

jCVb BbOCKS 

SIZE 

MOUNT PT 

preserve (Y/N) 

a 

0 

15884 

iiiiiiiiiii* 



b 

XXX 

33440 

16 



c 

0 

140624 

68 



d 

XXX 

XXX 

XXX 

/export/root 


a 

XXX 

XXX 

XXX 

/export/swap 


f 

0 

0 

0 



g 

XXX 

91256 

44 

/usr 


h 

XXX 

XXX 

XXX 

/home 


Ok to uae 

this 

partition table [y/n] 

■? y 



Ate you finished with this form ty/n] 1 n 

[x/X=*5elect choice! Cspace»next choicel ["B/''l’»backwardl {'‘F/‘N=*forward3 


The Main Menu wiU be displayed on the screen when you are finished with this form. 
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4 Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form wiU be displayed on the screen. Select software for the sun3 architecture. 


SOFTWAhB FORM [DEL=erase 

one char input data] [R£T=end of input data] 


Architecture Information ; 






Ilype : tstin2] 

x[sun3! 

[sun4] 

[SunSSSi] 



where executables 

reside : /usr 




Tape Information ; 






Device Type : tarOI 

tar8] tstOj [stSj 

tmtO] xIxtO] 



Drive Type : tlocall 

X[remote! 





Tapehost 1 godzllla 






Tapehost's Internet a<i(Jres3: 1&2. 

9.90.51 




Choice : xtall] 

[default! 

town choice] [required] 

tquitl 


CATEGORY 

NAME 

BYTES 

AVAIL BYTES 

Y/N 


required 

root 

XXXX 

XXXK 



required 

Sys 

XXXX 

XXXX 



rec[uired 

user 

XXXX 

XXXX 



desirable 

Networking XXXX 

XXXX 



Are you finished with this 

form fy/n] 

? 




[x/X*select choice3 Cepace®»next choice! ["B/ 

. . 

^p-backward] t '"F/ " 

N=*forward] 

__y 


The Main Menu will be displayed on the screen when you are finished with this forai. 
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Select software for the sim2 architecture: 


SOFTWARE FORM tDELssserase one char of input data] [RE!P«end of input data] 


Architecture Information 

Type : xEsunS] Esun3] taun43 (Sun386i3 

Path vhere executables reside : /e3i^rt/exec/8un2 

Tape Information : 

Device Type : {arO] Iar83 [atO] [st8J fmtO] xCxtO] 

Drive Type t flocal] xfremote] 

Tapehost : godzilXa 

Tapehost'^s Internet address: 192.^.90.51 
Choice : xfallj (default] lown choice] [required] (quit] 


CAIBGORY 

NAME 

BYTES 

AVAtl, BYTES 

Y/N 

required 

Sys 

xxxx 

XXXX 

y 

required 

user 

xxxx 

xxxx 

Y 

desirable 

Networking 

xxxx 

xxxx 

y 


Are you finished with this form (y/n] ? 

[x/X=select choice] [space^next choice] ["B/"P=bac}cward] ["F/"N=forward] 

^^ _ > 
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The list of categories to be extracted for the sun2 architecture are now displayed on the Software Form below: 

SOFTWARE FORM one char o£ Input, data] [BETs^end of input data] 

Architecture Information : 

Type t xfsutt2] tsun3] tsun4] tSttn38€i] 

Rath where executables reside : /es^ort/exec/sunZ 

Tape Information : 

Device Type : farO] Iar8] [stO] tstS] tmtO] xtxtO] 

Drive Type ; tlocal] x[remote] 

Tapehost : godzllla 

Tapehost'^s Internet address; 192,9,90.51 


Choice ; xtall] [default] town choice] trequired] tquit] 


Extract list; 

sys 

user 

Networkinq 


Are you finished with this form ty/n] ? n 

tx/X»select choice] [space=next choice) [ "^B/'‘P—backward) “N-forward) 
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Select software for the sun4 architecture: 


f 





- \ 

SOFTWARE FORM 

lOELsseraae one char of input data] [R£T=end of input data] 


Architecture Information 





Fype 

: [sun21 

(sun31 *[sun4] 

(Sun386il 



Rath wher« 

executables 

reside : /e3q>ort/exec/suu4 



Tape Information ; 





Device Type : tarOI 

(arSl (stO! (stSl 

tmtO] x(xtGl] 



Drive Type 

; (local! 

X [remote] 




Tapehost 

1 godzilla 





Tapehoat's 

Internet address; 192.9»90.51 




Choice 

: x{all] 

(default] (own choice] (required] 

(quit! 



CATEGORY 

NAME BYTES 

AVAIIt BYTES 

y/N 



required 

sys xxxx 

XXXX 




required 

user XXXX 

xxxx 




desirable 

Networking XXXX 

XXXX 



Are you finished with this 

form (y/n] ? 




Ix/Xs'select 

choice! [space»?next choice! ['B/ 

•'R«backward! C*F/" 

N=»forward! 

iiiiii;/ 


microsystems 


Revision A, of 9 May 1988 






Chapter 5 — Remote Installations 137 






138 Installing the SunOS™ 










Chapter 5 — Remote Installations 139 


CLXKNT FORM [DEXi=exase one char of Input data} [RET^nd of input data} 


ArOhit^CturO 

Choice 


f$un 23 at[3uii4j [Sun3B6i} 

X[create} [delete] fdisplay] [next arch] 


Client(a) : 

f redo 


Client Information ; 

Name 

Internet Addrese 
Ethernet Address 

YP Type : [none} [maeter] [slav 

Domain name 

Path of Client^3 Root 

Path of Client^s Swap 

Path of Client^$ Executables 

Path of Client^s Home 

Swap size (e.g* SM^rSm^SK,8k^S or $b> 


: frodo 
: ld 2 .d. 90.2 
: 8 : 0 : 20 : 1 : 00:01 
[slave] X(client} 

: wseng.sun.com 
: /ea^ort/root 
: /ejport/swap 
; /export/exec/sun4/ 
: /home 
r 8b> : 16M 


Are you finished with this fom ty/n] ?n 

(x/X=select choice} [Spa 06 *next choice} ("B/''P=«backward} f"F/'‘N«forwardJ 
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CLIENT FORM [DEXi=ecase one char of 

input data] [RET=end of input data] 

.^ 

Architecture Type : [$url2] (sun3] 

x[sun4] [Sun3B6i] 


Choice : x{create] 

[delete] [display] [next arch] 


Client(s) : 

<i3 



Client Information ; 



Name 



Internet Address 

: 192.9.90.2 


Ethernet Address 

: 8:0:20:1:00:02 


YP Type : [none] [master] 

[slave] X[client] 


Domain name 

: vseng.sun.com 


Path of Client's Root 

: /export/root 


Path of Client's Swap 

: /export/swap 


Path of Client's Executables 

; /export/exec/sun4 


Path of Client's Horae 

: /home 


Swap size {e.g. 8M, 8ni, 8K, 8k, 8 

or 8b> : 16 m 


Are you finished with this form ly/n] 



[x/X=select choice] [space^next choice] (''B/'‘P=backwardJ [ "F/"'N“forward] 

V. 

. j 


The Main Menu will be displayed on the screen when you are linished with this form. 
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6. Start the installation by selecting [start the installation] in the Main Menu and you will be 

prompted when the tape needs to be changed. If any information is missing, the installation will not start. You 
can abort the installation any time by using l c i'kL-C i and either restart it by using existing information or reas¬ 
sign information before restarting the instaUatioa You should be expecting the following messages after the 
installation begins. 


System Installation begin : 

Label disk(s) ; 

xyO xyl 

File systems check : 

/dev/rxyCla; 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72.0Mb in 47 cyl groups <16 c/g, 1.53Mb/g, 640 i/g) 
super-block backups (for fsck -b#) at: 

32, 3036, 6080, 9104, 12128, 15152, 18176, 21200, 24224, 27248, 

30272, 33296, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 81168, 84192, 87216, 

90240, 93264, 95776, 98800, 101824, 104848, 107872, 110896, 113920, 116944, 
119968, 122992, 126016, 129040, 132064, 135088, 138X12, 


lots of texts 


** /dev/xyOa 

** Currently Mounted on /a/ 

** Phase 1 - Check Blocks and Sizes 

2 •* Check Pathnames 

3 - Check Connectivity 

4 ■*' Check Reference Counts 

5 - Check Cyl Groups 


** Phase 
** phase 
** Phase 
** Phase 


/dev/rxyOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 
System Installation Coit 5 >leted. 

Reboot your system and configure a kernel for your system. 
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7. Abort the system since the reboot option is not being selected in the Host Form. Use I Ll-A I for Sim monitors or 
[BREAK! on Wyse terminals to abort the system. Boot the system by using the command 



8. Configure a kernel for your system. Refer to Chapter 7 for instmctions on how to configure a kernel. 

9. Run ypinit to set up the yp database. See System and Networic Administration Manual for detailed instmc¬ 
tions on how to set up and maintain yellow pages. 
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5.6. Dataless Configuration With Remote Tape Drive 

Assume the system is configured as follows: 

hostname: evans 

architecture: sun4 

ethemet interface: ieO 

system type: dataless configuration 

ip address: 192.9.90.64 

yp client domainname: "wseng.sun.com" 

1 SCSI disk: sdO 

remote SCSI tape drive abbreviation: stO 

sun4 tape host: godziUa 

tape host’s internet address: 192.9.90.11 

sun4 server: godzilla 

server ip address: 192.9.90.51 


1. Start suninstall: 
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# cd /usr/et^c/install 

# suninstall 

Ent^E the local tiifto zono name: 

» US/j^acific 

Is this the correct date/time ty/nj: 
Mon Mar 14 08:08:57 PST 1&$8 


Enter the current date and local time (e.g* 09/03/88 12:20:30); the date 
may be in one of the following formats: 
dd/mm/yy 
dd/mm/yyyy 
dd.mm.yyyy 
dd--inm-yyyy 
dd-mm-yy 
month dd^ yyyy 
dd month yyyy 

and the time may be in one Of the following formats: 
hh ctm/pm 
hh:mm am/pm 

hhiram am/pm 

||||||||||||ii|iiiii|||||||||||||||||||i;||;:||||||^ 

hh:mm:ss am/pm 
hh:mm:ss 
hh^mm.ss am/pm 
hh*mm.ss 

» 09/03/88 12:20:30 

is this the correct date/time [y/nj: 

Wed Mar 9 12:20:30 PST 1988 


Select your terminal type:. 

1) Televideo 925 

2) Wyae Model 50 

3) Sun Workstation 

4) Other 


The following menu will now appear. 
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Sun Microsystems System Installation Tool 
Main Menu 

< Flease use x or X to select your choice ) 
( 4 means the <iata file($) exist(s) ) 


[ assign host information } 
[ assi=^n disk information ] 
[ assign software information J 
[ assign client information 3 
I on--line helf> information J 
{ start the installation 3 
[ exit from suninstall 3 


fx/X=seleOt choice! fspace^next choice3 l'"B/"P«t)ackwardJ [ ""F/ "N==f0rward3 


2. Assign host information by selecting [assign host information] in the main menu and the Host Form 
wiU be displayed on the screen: 


HOST FORM 


[DEX^rase one char of input dtataj [RET^end of input data! 


Workstation Information : 

Name : eirana 

Type : [standalone] [server] x:[datalessl 
Server; godrilla 

Server Internet Address: 192.9^90.XI 

Path of the executables on server: /export/exec/sun4 


Network Information ; 

Ethernet Interface : [none] x[ie0] 
Internet Address Q ; 192.9.90.64 

yp Type : [none] [master! 

Domeinname ; wseng.sun.com 


[slave] X[client! 


Misc Info inflation ; 

Operation type : x[ install] 

Reboot after completed ; (y! at[n] 


[upgrade] 


Are you finished with this form fy/n] ? y 

[x/X-select choice] [space-next choice] I"B/'"P-backward] f^F/^N-forward] 
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3. Assign disk infonnation by selecting [assign disk information] in the Main Menu and the Disk Fonn 
will be displayed on the screen: 


r 





-N 

DISK I’ORM t£>Blr=ej:ase one char of input data} 

[RBT=end of input data] 


Attached Disk Devices t 





xt sdOl 






Disk Label 


xldefaultl 

[existing] 

{label in data file] 


Free Hog Disk 

Partition : 

[al fdl 

[6] [f] x[g3 

[h] 


Display Unit 

; X [Mbytes3 

[Kbytes] [bytes] [blocks] [cylinders] 


PARTITJON START^CYL BLOCKS SISE 

MOUNT PT 

PRESERVE (Y/N) 


a 0 

15884 7 

/ 



b 0 

33440 

16 




c 0 

140624 

68 




d 0 

0 

0 




e 0 

0 

0 




f 0 

0 

0 




g 0 

91256 

44 




h 0 

iiiiiiiiiiiiiiilii;; 

0 




Ok to use this 

partition table [y/n] 

■? y 



Are you finished with this 

f03^m fy/n] 

? y 



Ix/X-seiect 

choice] [space-ne^ct choice] 

backward] { '"P/ "N-f orward] 


V 







The numbers under the columns START_CYL, BLOCKS, and SIZE are for this example only. The numbers will be 
different for each disk and they depend on the existing label on the disk specified. The main menu will be displayed 
on the screen when you are finished with the form. 
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4. Assign software information by selecting [assign software information] in the Main Menu and the 
Software Form wiU be displayed on die screen: 


—^^^ 
SOFTWARE FORM [DEl,=erase One char of input tJataJ [RET^enti of input data] 

Architecture infomation : 

: tsun21 tsun31 3t[sun4] [Sun3B€i1 

:?ath where e^^ecutabiee reside :/ 

fape information : 

Device Type : {arOI t^r83 [at01 actatSj tititOJ f^tOl 
Drive Type : {iocal} x[remote] 

Tapehost : godzilla 

. ‘fapehost^s Internet Address : 192.d.$0.11 

Choice : tall] [defanlt] [own choice] xCreguired] [quit] 


CATEGORY NAME 

required root 

req[uired Sys 

required user 

Are you finished with this form [y/n] ? 

{x/x=select choice] [space=next choice] ["B/'P^backward] ["^F/"N=forwardl 

k___ 


BYTES AVAIL BYTES Y/N 

XXXX XXXX y 
XXXX XXXX y 
XXXX XXXX y 


Dataless configuration does not need to select software categories since it is mounting /usr from the server. Some 
of the required categories will be loaded for installation purposes. 
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The list of categories to be extracted for the sun3 architecture will now be displayed on the Software Form below: 


f SOFTWARE FORM 

tDEL^erase one char of input data] [BET=end of input data] ^ 

Architecture Information : 

Type 

: tsun21 [sunSl xC5un43 [Sun386i] 

Path where 

executables reside :/ 

Tape Informtion 


Device Type 

; tarO] far8] [stO] »[st8] [mtO] IxtO] 

Drive Type 

1 f local] atf remote] 

Tapehost 

; godzilla 

Tapehoat^s 

Internet Address : 192.9.97.11 

Choice 

: fall] fdefault] town choice] xfrequired] [quit] 

Extract list: 







Are you finished 

with this form Ty/n] ?y 

[x/X=select choicel tspace=next choicej ["B/"P=backwardI f''F/"^N«forward] 

V _ 


Only a portion of the user category will be loaded. The Main Menu wiU be displayed on the screen when you are 
finished with this form. 
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5. Start the installation by selecting [start the installation] in the Main Menu and you will be 

prompted when the tape needs to be changed. If any information is missing, the installation wiU not start and the 
Main Menu will be displayed on the screen. You can abort the installation anytime by using [ CTRL-C ) and either 
restart it by using existing information or reassign information before restarting the installation. You should be 
expecting the following messages after the installation begins. 


System Installation begin : 

Label <iisk(s) : 

File systems check : 

/dev/rsdOa: 140624 sectors in 752 cylinders of 11 tracks^ 17 sectors 

72,0Hb in 47 cyl groups (16 c/g^ 1^53Kb/g, 640 i/g) 
super-^biock backups (for fsck ^b#) at: 

32, 3056, 60B0, 9104, 12128, 15152^ 18176,. 21200, 24224, 27248, 

30272, 33296, 36320, 39344, 42368, 45392, 47904, 50928, 53952, 56976, 

60000, 63024, 66048, 69072, 72096, 75120, 78144, 81168, 84192,. 87216, 

90240, 93264, 95776, 98800, 101824, 104848, 107872, 110896, 113920, 116944, 
119968, 122992, 126016, 129040, 132064, 135088, 138112, 

sun3 Installation Begin ; 

Extracting ”root” files from •^/dev/nrstO” release tape^ 

Extracting ^‘Sys” files from ”/dev/nrst0’* release tape. 

Extracting sun3 executables from *Vdev/nr5t0” release tape. 

Checking filesystems : 

** /dev/sdOa 

** Currently Mounted on /a/ 

Phase 1 - Check Blocks and Sizes 
** phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
Phase 5 - Check Cyl Groups 

/dev/rsdOa: 516 files, 2575 used, 4896 free (16 frags, 610 blocks) 

System Installation Completed. 

Reboot your system and configure a kernel for your system. 
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6. Abort the system since the reboot option is not being selected in the Host Form. Use (Ll-Al for Sun monitors or 
[ BREAK 1 on Wyse terminals to abort the system. Boot the system by using the command 

-s 

7. Configure a kernel for your system. Refer to Appendix A for instructions on how to configure a kernel. 
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Man Pages 


Man Pages 
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Man Pages 


juni/wto//has two new utilities, setup_client(8) and setup_exec(8). 
The man pages for these utilities are on the following pages. 
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SETUP_CLffiNT(8) 


MAINTENANCE COMMANDS 


SETUP_CLIENT(8) 


NAME 

setup_client - create or remove an NFS client 
SYNOPSIS 

/usr/etc/mstall/script/setup_client op clientname ypjype swapsize rootpath swappath 
dumppath homepath execpath arch 

DESCRIPTION 

setup^client adds an NFS client to a server, or to removes one. It can only be run by the super-user. It is 
also used by suiiinstall(8). 

The op argument indicates which operation to perform; it can be either add or remove, to indicate whether 
to add or remove a client, clientname is the hostname of the client ypjype indicates the type of Yellow 
Pages server or service to provide to the client, if any; it can be one of master, slave, client or none. 
swapsize is the number of bytes reserved for client’s swap file, rootpath is the pathname of parent direc¬ 
tory in which various client root directories reside; rootpath!clientname is the pathname of the client’s root 
directory, swappath is the pathname of parent directory in which various client swap files reside; 
swappath!clientname is the pathname of the client’s swap file, dumppath is the parent pathname in which 
various client dump files reside; dumppath!clientname is the pathname of the client’s dump file, homepath 
is the pathname of the (parent) directory in which the various home directories are to reside; it is the path¬ 
name of the directory that the client is to mount as /home, execpath is the full pathname of the directory in 
which the executables for the architecture specified by the arch argument. This is the directory that the 
client mounts as /usr. arch specifies the client’s architecture (for instance, sun4, sun3...). setup_client 
with no arguments displays a usage message that includes the proper arch argument for each supported 
architecture. 

USAGE 

Before you add or remove a client, you must first make sure that the Internet and Ethernet addresses for 
clientname are listed in the YP hosts database (if the server is running the YP), or in the server’s /etc/hosts 
and /etc/ethers databases, respectively (otherwise). Then, run setup_client with the add or remove opera¬ 
tion. When adding a client, you must then bootstrap that client machine. 

You cannot add a client to a server that does not support the specified architecture. The executable direc¬ 
tory for that client’s architecture must be present on the server. If this file is absent, an error results. 

setup^client updates the /etc/bootparams file. If the server is a YP master, it updates local YP database. It 
does not propagate the local update to other YP servers. To propagate the updates, use the following com¬ 
mands: 

example# cd /var/yp 
example# make 

If the server is running YP but is not a YP master, setup_client issues a warning to indicate that the data¬ 
base is out of date. 

When arch is given as sun2, suninstall issues a reminder to run the /usr/etc/ndbootd daemon for booting 
Sun-2 systems. 

setup_client creates swappath!clientname with the size, (number of bytes) you specify. You can append 
one of K or k to indicate Idlobytes, M or m to indicate megabytes, or B or b to indicate 512-byte blocks, to 
size. Otherwise, size is taken to indicate an exact byte count 

suninstall updates the /etc/exports file to allow root access to each client’s root file system. It exports the 
client’s swap and dump partitions only to the client. Note: the system administrator should verify that the 
/etc/exports file contains correct information, and that file systems are exported to the correct users and 
groups. Refer to exportfs(8) for details on exporting file systems. 
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MAINTENANCE COMMANDS 


SETUP_CLIENT(8) 


EXAMPLES 

This example shows how to add a Sun-4 system NFS client to a server. 

example# setup jclient add frodo client 16M /expwts/roots /exp<H*ts/swaps /exports/dumps /home \ 
/exports/execs/sun4/4.0 sun4 

To remove this client, you would merely substitute remove for add in the above example. 

FILES 

/etc/hosts 

/etc/ethers 

/usr/etc/ndbootd 

/etc/bootparams 

/etc/exports 

SEE ALSO 

exportfs(8), setup_exec(8) sunkistalKS) 

Installing SunOS 
DIAGNOSTICS 

incorrect number of arguments 

Check number and order of the sffguments. 

must be run as root (super-user). 

You must be root to use setup_client. 

invalid operatim type 

Valid operations are add and remove. 

ATTENTION: xxxxxxxx -> boot.sun? not created. 

(Sun-3 systems only.) A symbolic link can not be created because the boot file does not exist. 

ATTENTION: xxxxxax.SUN? -> boot.sun? not created. 

(Other than Sun-3 systems.) A symbolic link can not be created because the boot file does not 
exist. 

ATTENTION: /usr/etc/ndbootd needs to be running on server before bringing up ^‘clienf\ 

The Sun-2 system boot daemon must be running in order to bootstr^ a Sun-2 system. 
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MAINTENANCE COMMANDS 


SETUP_EXEC(8) 


NAME 

setup_exec - install architecture-dependent executables on a heterogeneous file server 
SYNOPSIS 

/usr/etc/mstall/setup_exec arch execpath 
DESCRIPTION 

setup_exec installs architecture-dependent executables from either from a local tape drive or a remote host. 
It is used to convert a standalone system or homogeneous file server to a heterogeneous file server. 
setup_exec is a forms-based utility that can be invoked directly, but it is also used by suninstall(8). It can 
only be invoked by the super-user. 

The arch argument specifies the machine archictecture to install (for instance, sun4, sun3...). When run 
with no arguments, setup_exec displays a usage line that includes the proper format of the arch argument 
for each supported architecture, execpath is the full pathname of the directory in which to install the exe¬ 
cutables. When setup__exec is done, the execpath directory is ready to mount as /usr by the heterogeneous 
server’s NFS clients of the indicated arch, 

setup_exec also updates the /etc/exports file (see exportfs(8)) to export die executable directories it has 
installed. The system administrator should verify this file to make sure that the directory has been exported 
to the correct groups. 

EXAMPLE 

This example shows how to install a directory of executables fac Sun-4 system clients running 4.0. 
example# setup_exec sun4 /exports/execs/sun4/4.0 

FILES 

/etc/hosts hosts database 

/etc/ethers dat^ase of hostnames and Ethernet addresses 

/etc/exports database of exported file systems 

/usr/etc/iiistall/files/extractlist.arc/i record of extracted categories for the indicated architecture 
SEE ALSO 

exportfs(8), setup_cUeiit(8), sttninstall(8) 

Installing SunOS 
DIAGNOSTICS 

incorrect number of arguments 

Check the number and the order of arguments. 

invalid architecture type “orcA”. 

You supplied a value for arch that is not suppeated. 

invalid tape drive type ^^drive*\ 

Valid tape drive types are local and remote. 

invidid tape type ^Uape^\ 

Valid tape types are ar, st, mt, and xt. 

can’t reach tapehost ^Uapehost*\ 

The IP address of tapehost is not in the hosts database, that is, the hosts YP database if the Yellow 
Pages are running, or the /etc/hosts file otherwise. 

Load release tape n 

Mount the release tape specified on the screen and type RETURN to continue. 
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Server 


Converting a Standalone System into a Server 


159 







7 



Converting a Standalone System into a 

Server 

A 4.0 standalone system can become a 4.0 server by running setup_exec and 
setup_client. setup_exec is a tool that installs the excutable files for 
the architecture you specify. You can use it to install as many architectures as 
you need on the server as long as there is enough disk space available on the 
^sk. 

NOTE You can no longer use extract_release to extract additional software if 
you do not want to go through suninst all after you have installed a system. 
You must use setup_exec to extract software from the same or other archi¬ 
tectures or go back into suninstall. 

For example, if you have a sun2 4.0 standalone system and you wish to turn it 
into a 4.0 server that supports sun2 and sxm3 4.0 clients, run setup_exec to 
install simS executable files on the system. You do not have to run 
setup_exec to install sun2 executable files since the system is a sun2 4.0 sys¬ 
tem already. To see the usage of setup_exec, type the following: 


- \ 

hoet #9etup_e3t«o 

setup_ex«ot incorrect nuitiber of argumenta, 
naage; $e:top_jexec arch cxecpath 


where: 

arch “ ”8un2" or ”sun$" ,,,, 

execpath « pathname of the directory where exec exists 

> 


arch is the architecture of the executable files you want to install, execpath 
is the location you want the executable files to reside. If you want the executable 
files to be under /exec/sun3, execpath is /exec. 


When the first client is being added to a standalone system it is necessary to add 
/usr and the filesystem which wiU be the client’s "home" to /etc/exports 
and then execute export fs -a or reboot the server. 


Also, before the first client is added to a standalone system that has been 
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converted to a server, it is necessary to start bootparamd after running 
setup_client either by executing /usr/etc/rpc .bootparamd orby 
rebooting the server. 

The commands for both the local tape drive and the remote tape drive are exactly 
the same. 


f ^ 

host# sotup^^xec iluh3 /exftd 

. ... 


Now you will be prompted for tape drive information in very much the way 
suninstall's Software Form does. Fill in the necessary information. See the 
setup_client and setup_exec man pages in Chapter 6 of this manual for 
more information. 
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Adding or Deleting a Client. 163 

Options. 164 

EXAMPLES:. 164 

Adding a Sun-2 Qient. 164 

Removing a Sun-3 CHient. 164 

Adding a Sun-4 Client. 164 












Adding or Deleting a Client 


NOTE 


Run setup_client to create Sun-2, Sun-3 and Sun-4 clients. 
setup_client creates or removes one client at a time. The command is 
located in /usr/etc/install/script/setup_client so it is neces¬ 
sary to cd /usr/etc/install/script prior to executing 
setup_client. Seethe set up_client man page in Chapter 6 for com¬ 
plete information. 

The client must be added to /etc/hosts amf /etc/ethers on f/ie server 
or the YP master prior to running setup_client. 

To see the usage of setup_client, type the following: 


incorrect rmmber of arguruents* 

usager 

setup^client op clientname yp^type size rootpath swappath homepath exeepath arch 
op ~ "add" or "remove" 


YP_tYPd 

siie 


name of the client machine 
^ "master" or "slave" or "client" or "none" 


siie w sl^e for swap 

<e,g» .16M: or l^ro “> 16 * 104$5t76 bytes 
16K or l€k ===««> 16 * 1000 bytes 
16 b or l^b ==> 16 * 512 bytes 
16 «»"> 16 bytes ) 

rootpath pathpathname of nfsroot 
swappatb w pathname of nfsswap 

dumppath *== pathname of nfsdnmp 

bomepath » pathname of home 

exeepath ^ pathname of exec directory 

arch w "sun2" or *^sun3** .... 
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Options op is add or remove a client from the server. 

name is the hostname of the client. 

YP is the yp type of the client. 

si ze is the size of the swap space in bytes reserved for the chent. 
rootpath, swappath, diimppath, homepath and execpath are 
the locations of the client directories, 
arch is the client’s architecture. 

If you are adding a client, setup_client sets up client information under the 
directories you specify. If you are removing a client, setup_client removes 
the client information under the directories you specify. 

If you want client’s root directory under /roots/ clientname, rootpath is 
/roots. If you want client’s swap space under / svaps / clientname, swappath 
is / swap s. If you want client’s dump file under / dump s / clientname, dump- 
path is /diimps. If you want client’s home directory imder 
/home/clientncune, homepath is /home. If Sun-2 executable files are under 
server’s /exec/ sun2 and the client is a Sun-2 client, execpath is /exec, 
arch is the client’s architecture. 


EXAMPLES: 

Adding a Sun-2 Qient 


. .... ' ----N 

host# setup^client add aofla client /roots /swaps /dumps /botne /exec sun2 


Removing a Sun-3 Qient 


host# setdp^pllent remove Sofia client 16 /roots /swSps /dusps /borne /exec Sun3 

V_______^^_ J 


Adding a Sim-4 Qient 


host# setup^client add sofia client 16K /roots /swaps /dus^s /borne /exec sun4 
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Reconfiguring Your Kernel 


This section contains instnictions for reconfiguring the kernel. Remember that 
before performing these instructions, you must have installed Release 4.0 by 
using the suninstall program. You also must be logged in as superuser. 

Two sets of instructions follow; one for standalones and oiw for servers. You 
should refer to the set that applies to your configuration. Remember that if you 
are configuring a server, you also need to configure the kernels for your diskless 
and dataless clients. 

Kernel Reconfiguration for For standalone machines, proceed as follows. 

Standalone Systems j Change the current directoiy to the following: 

.^..‘ ..- ‘ .“ ' x 

# cd /usr/share/sys/sxui^/conf 


Procedures for Reconfiguring 
the Kernel 


NOTE For Sun#, substitute the system type:surt2, sun3, sun4, etc. 

2. Create a kernel configuration file. 

Copy the file GENERIC and comment out the lines that don’t apply to your 
system. Call the new file SYS_NAME, where SYSjfAME represents the name of 
your system. Also in the conf directory are a number of templates for sys¬ 
tems, such as “DL 50” for diskless 3/50. You can use these, rather than 
modifying GENERIC, where appropriate. Here are the commands that you 
type: 


# 

cp GENERIC SYS FAME 

\ 

# 

L 

Chmod +w SYS FAME 

. J 


3. Edit SYS_NAME to reflect your system configuration. Refer to the aimotated 
copy of GENERIC for your model of Sun workstation provided in the previ¬ 
ous section for an explanation of these changes. Make sure you are includ¬ 
ing the proper device description lines for your system. 

4. Wltile stiU in the /usr/share/sYs/sun#/conf directory, run 
/usr/etc/conf ig. Then change directory to the new configuration 
directory, and make the new system as shown below. (Remember to substi¬ 
tute your actual system image name fox SYS_name)\ 
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.— ...—- > 

# /usr/etc/con£lg S¥SjfAMB 

# cd ,,/sysjiAUE 

# make 

[ tm<f output 3 

.. .. 


5. Now you can save your old kernel and install your new one as follows: 



6. If the system appears to woik, this completes the upgrade procedure. If the 
new kernel doesn’t seem to be functioning properly, boot / vmunix. old, 
copy it back to /vmunix, and go about fixing your new kernel as follows: 

f -------- 

# /usr/ekc/slmtdoMa -k now 
5>- b vmunix.bid -a 

# mv /vmunix /vmundx. oops 

# mv /vmunix.Old /vmunix 

# ‘D t Brings the system up mM-user ] 

<_ ^ 

Kernel Reconfiguration for 
Servers 


For server machines, proceed as follows. 


1. Change the current directory to /usr/share/sys/sun#/conf: 



2. Create a kernel configuration file. In the conf directory are a number of 
templates for systems, such as “DL 50’ ’ for diskless 3/50. You can use 
these, rather than modifying GENERIC, where appropriate. 


Copy the file GENERIC and comment out the lines that don’t apply to your 
system. We’U call the new file sys name (the name of the system). For 
example. 



# cp GBNBRIC SYSNAME 

\ 


# chmod +w STSjmm 

J 


3. Edit SYS NAME to reflect your system configuration.Use the aimotated copy 
of GENERIC provided in the next section for an explanation of these 
changes. Make sure you include the proper device description lines for your 
system. 



sun 

microsystems 


Revision A, of 9 May 1988 





Appendix A — Reconfiguring Your Kernel 169 


4. While still in this directory, run lusrletclcor^g. Then change to the new 
configuration directory, and make the new system (remember to substitute 
your actual kernel image name for SYS jfAME): 
-— 

f /USS/fttC/COttfig SYSJNAMB 
# cd . ./SYSjmiE 
. f iaak« 

1 lots output 3 

..-..—.. n J 


5. Prepare a kernel for your clients in the same way. In the conf directory 
you win find templates for various configurations. Replace 
TEMPLATE J^AME with the appropriate template for your system. When 
editing the configuration file (called cijent_kernel_NAME in the following), 
remember to include the entire set of devices used by aU the machines or 
configure a custom kernel for each client or client configuration: 

NOTE A kernel for Sun-2 clients MUST be built on a Sun-2; Sun-3 kernels on a Sun-3; 

and Sun-4 kernels on a Sun-4! 


-^-) 

f cd /eys/dua#/cOnf 

# cp TEMPLATEJlAAiB CUENTJCESiNELJiAME 

# chiisod +w cumrmmBinmE 

[ Edit CUS^JCERNELJUMP to reflect all clients’^ systems. 

Be especially careful with the device description lines. I 

# /usr/etc/configr CUmrjCERNELJtAME 

# Cd .,/ajsmjBmmjiAMB 

# make 

C lots of output 3 

^. ...._> 


6. Install the appropriate client kernel under each client’s root directory. 

Clients do NOT have to be halted, but they must reboot to run the new ker¬ 
nel. To install each client’s kernel, save the original kernel (if there is one), 
install the new kernel image in /export /root /client_name, and 
then test it out by booting each of the clients. Since clients usually aren’t 
identical configurations, you need to make sure each client boots. 


. .. . . 

# «d /viUX/»hmx»/B)f»/sun»/CUBNTjmNELjtAUB 

#imr /mxpox:t/xoot/client_ruinie/vm3nijL /vxpozt/xoot/cJientjume/vmanLx, 
{or wherever your client kernel w] 

# cp vanmix /•xport/roo(:/c/ten{_Rame/vniuniJE 

[ Onthe client machine : { 

>b vnnuiix 

.. . j 


old 


NOTE Executables for the native architecture are in /usr. Second and third architec¬ 

tures, by default, go in / export /exec/ sun# 
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7. Now position yourself in the directory which has the server’s kernel in it. 
Save your server’s old kernel, install your new one, and try everything out: 


# mv /vntonlx /vmunlx.old 

# cp vonanlai: /vmeuniac 



8. At this point normal system performance is a highly, but not absolutely, cer¬ 

tain indicator of a trouble-free kernel, if your system(s) appears to work you 
may proceed with some confidence. You have successfully completed 
installation. Congratulations! 

If, on the oflier hand, either of the new kernels does not seem to be function¬ 
ing properly, halt all systems and boot from the original kernel. Move the 
faulty kernel away and re-install the original in its place. Once you are 
booted up on the original, you can go about trying to fix the faulty kernel. 
For example, on the server: 



For the clients, do the following on the server: 


# ed /^pB^xt/root/dient^^name 

# mv vxDunlat womlx.bad 

# mv vnnuxix.old vmunix 

Boot up the clients and allow them to run imtil a new client kernel is made and 
ready to install; or if the clients can remain down, build and install a new client 
kernel now. 

For specific Annotated GENERIC files for a Sim-2, Sun-3, or Sun-4 machine, see 
the System Administration and Networking manual. 
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TIME ZONE NAME: 


173 







B 

Time Zones 


TIME ZONE NAME: TIME ZONE AREA: 

North America: 


US/Eastem 

US/Central 

US/Mountain 

US/Pacific 

US/Pacific-New 


USA^ukon 

US/East-Indiana 

us/Arizona 

us/Hawaii 


Eastern time zone, U.S.A. 

Central time zone, U.S.A. 

Mountain time zone, U.S.A. 

Pacific time zone, U.S.A. 

Pacific time zone, U.S.A., 

with proposed changes to Daylight Savings 

Time near election time in Presidential 

election years 

Yukon time zone, U.S.A. 

Eastern time zone, U.S.A., 
no Daylight Savings Time 
Mountain time zone, U.S.A., 
no Daylight Savings Time 
Hawaii 


Canada/Newfoundland 

Canada/Atlantic 

Canada/Eastem 

CanadaAI^entral 

Canada/East-Saskatchewan 

Canada/Mountain 

Canada/Pacific 

Canada/Yukon 


Newfoundland 
Atlantic time zone, Canada 
Eastern time zone, Canada 
Central time zone, Canada 
Central time zone, Canada, 
no Daylight Savings Time 
Mountain time zone, Canada 
Pacific time zone, Canada 
Yukon time zone, Canada 


Europe: 


GB-Eire 

WET 

Iceland 

MET 

Poland 

EET 


Great Britain and Eire 
Western European time 
Iceland 

Middle European time (also known as 
Central European time) 

Poland 

Eastern European time 
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Turkey Turkey 

W-SU Western Soviet Union 

Asia (including Australia and New 2^aland): 


PRC 

People’s Republic of China 

Korea 

Republic of Korea 

Japan 

Japan 

Singapore 

Singapore 

Hongkong 

Hong Kong 

ROC 

Republic of China 

Australia/Tasmania 

Tasmania, Australia 

Australia/Queensland 

Queensland, Australia 

Australia/North 

Northern Territory 

Australia/West 

Western Australia 

Australia/South 

South Australia 

Australia/Victoria 

Victoria, Australia 

Australia/NSW 

New South Wales, Australia 

NZ 

New Zealand 


Other (if the locale isn’t listed above); none of these have Daylight Savings 
Time: 


GMT 

GMT-1 

GMT-2 

GMT-3 

GMT-4 

GMT-5 

GMT-6 

GMT-7 

GMT-8 

GMT-9 

GMT-10 

GMT-11 

GMT-12 

GMT+13 

GMT+12 

GMT+11 

GMT+10 

GMT+9 

GMT+8 

GMT+7 

GMT+6 

GMT+5 

GMT+4 

GMT+3 


Greenwich Mean time 

1 hours west of Greenwich Mean Time 

2 hours west of Greenwich Mean Time 

3 hours west of Greenwich Mean Time 

4 hours west of Greenwich Mean Time 

5 hours west of Greenwich Mean Time 

6 hours west of Greenwich Mean Time 

7 hours west of Greenwich Mean Time 

8 hours west of Greenwich Mean Time 

9 hours west of Greenwich Mean Time 

10 hours west of Greenwich Mean Time 

11 hours west of Greenwich Mean Time 

12 hours west of Greenwich Mean Time 

13 hours east of Greenwich Mean Time 
12 hours east of Greenwich Mean Time 
11 hours east of Greenwich Mean Time 
10 hours east of Greenwich Mean Time 
9 hours east of Greenwich Mean Time 
8 hours east of Greenwich Mean Time 
7 hours east of Greenwich Mean Time 
6 hours east of Greenwich Mean Time 
5 hours east of Greenwich Mean Time 
4 hours east of Greenwich Mean Time 
3 hours east of Greenwich Mean Time 
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GMT+2 

GMT+l 


2 hours east of Greenwich Mean Time 
1 hours east of Greenwich Mean Time 
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